Mirror layar device hitam (blank) adalah issue paling umum. Ini akar penyebab + fix-nya.

1. Device tidak fully authorized

Gejala: Device muncul di list tapi status "offline" atau "unauthorized". Thumbnail hitam.

Fix:

  1. Cabut USB, colok ulang
  2. Unlock screen phone — akan muncul dialog "Allow USB debugging from this computer?"
  3. Centang Always allow → OK

2. scrcpy-server.jar push gagal

Gejala: Log engine ada line push jar: ... + error. Thumbnail permanen hitam.

Fix:

  • Restart PhoneGrid (tray → Keluar → buka lagi)
  • Kalau persist, reinstall PhoneGrid (uninstall + install ulang)

3. Codec decoder mismatch (Intel iGPU)

Gejala: Thumbnail hitam di PC dengan Intel iGPU tertentu. Log browser DevTools error decoder.

Fix sudah included sejak v1.1.4:

  • Auto-fallback ke software decoder
  • Codec derive dari SPS header stream
  • Kalau masih hitam, force software: localStorage.setItem('mirrorMode','agent') di DevTools console

4. Port allocation range (affect hosts with MuMu/LDPlayer heavy)

Gejala: 1-2 thumbnail work, sisanya hitam. Log: alloc port: failed to allocate free port outside node range

Fix sudah included sejak v1.1.6:

  • Upgrade ke PhoneGrid v1.1.6+ (saat ini v1.2.4)

5. WiFi device lag

Gejala: Mirror bisa tapi sangat lambat atau freeze.

Fix:

  • Pastikan PC + phone satu WiFi subnet yang sama
  • Router bagus (tidak lewat VPN/mesh extender kalau bisa)
  • Close aplikasi streaming lain di phone (YouTube, Instagram live)

6. ADB server stuck

Gejala: Multiple device error random.

Fix:

adb kill-server
adb start-server

Tutup + buka lagi PhoneGrid.

7. Windows defender / AV

Gejala: engine.exe atau adb.exe di-quarantine. %APPDATA%\PhoneGrid\logs\engine.log kosong.

Fix:

  • Windows Security → Virus & threat protection → Exclusions → add folder C:\Program Files\PhoneGrid\
  • Restore quarantined files kalau sudah kehapus

Kirim log untuk diagnose

Kalau semua fix di atas tidak bekerja:

  1. Tray PhoneGrid → Buka folder log
  2. Kirim engine.log + backend.log ke support
  3. Screenshot Mirror Monitor saat hitam + DevTools Console (Ctrl+Shift+I)

Lihat Cara Kirim Log untuk detail.