# Cara pasang APK IPTV perbaikan — versi 2.7.1.87

APK ini adalah **versi perbaikan** dari aplikasi pemutar IPTV yang dipakai pelanggan, untuk mengatasi
keluhan **“ada suara tapi gambar hitam”** pada sebagian TV (mis. TCL Android TV 12). Mesin pemutar diubah
agar tidak memaksa dekode perangkat keras.

## Berkas

| Varian | Berkas | Untuk apa | SHA-256 |
|---|---|---|---|
| **sw2** (disarankan) | `iptv3-2.7.1.87-sw2.apk` | dekode perangkat lunak penuh (IJK) — kualitas paling dekat VLC | `016a5045a82264a7dec97eaf39ac2e384db8fd1982e27322043863251c88af35` |
| exo | `iptv3-2.7.1.87-exo.apk` | memakai ExoPlayer — lebih ringan, sedikit lebih kasar dari sw2 | `ffd3eeaf8a01951145852b4a115e8db1f66575a7dd91eb2c8bc307cf4fe70993` |

Versi di dalam berkas: **versionName 2.7.1.87 · versionCode 20701087** (nama paket tetap
`com.dexin.wanchuan.iptv3`). Ukuran masing-masing 51.367.774 byte.

## Langkah pemasangan (di TV/Android box)

1. **Copot dulu aplikasi lama.** Tanda tangan APK perbaikan berbeda dari APK bawaan penjual, jadi Android
   menolak memasang di atasnya. Setelan → Aplikasi → IPTV → **Uninstall** (atau “Copot pemasangan”).
   *Catatan: mencopot tidak menghapus langganan/akun; cukup masukkan kembali daftar channel bila diminta.*
2. Aktifkan **“Sumber tidak dikenal”** (Setelan → Keamanan → Instal aplikasi tidak dikenal) untuk aplikasi
   pengelola berkas yang Kakak pakai.
3. Pasang berkas `iptv3-2.7.1.87-**.apk**` (salin lewat USB drive, atau unduh langsung dari TV bila ada
   peramban berkas).
4. Setelah terpasang, buka **Setelan → Aplikasi → IPTV**: pastikan versinya tertulis **2.7.1.87**.
5. Uji satu channel yang dulu hitam. Kalau masih hitam dengan varian `sw2`, berarti kodek channel itu di
   luar kemampuan TV — kirim satu alamat channel yang bermasalah, nanti diperiksa.

## Kalau masih hitam

- Coba varian **exo** (beban CPU lebih ringan).
- Kalau dua-duanya masih hitam, uji channel yang sama dengan **VLC** di TV itu:
  - VLC juga hitam → masalahnya di TV/kodek channel, bukan aplikasi.
  - VLC normal → kirim kabar, kita siapkan varian lain.

## Berkas asli & jejak kerja

- APK asli yang diunggah pemilik: `/root/unggahan/20260924-134348-iptv3_2.7.1.86_20260522.apk`
  (SHA-256 `48379104cab2e3af…`)
- Pohon suntingan & log bangun: `/root/laporan/apk-perbaikan/` (`pohon2-sw2/`, `pohon2-exo/`,
  `bangun4-*.log`, `tanda4-*.log`)
- Langkah lengkap bedah & polanya: skill `android-apk-inspection` →
  `references/iptv-playback-black-screen.md`