# Samsung Tizen SDK dan evaluasi di TV
Instal pemutar evaluasi Samsung TV, konfigurasikan dan tandatangani WGT, lalu integrasikan Widevine VOD dengan Tizen Universal Player SDK.
**Samsung TV menggunakan aplikasi Web Tizen.** Panduan ini mencakup Widevine DASH VOD dengan Samsung AVPlay. Gunakan kit evaluasi publik untuk mencoba pemutar, atau Professional/Enterprise SDK untuk menghubungkan backend Anda sendiri.
## 1. Unduh perangkat evaluasi TV publik[#](#try-tv-app)
[Unduh Samsung perangkat evaluasi ZIP](https://docs.drm-x.com/downloads/tizen/20260918.3/drmx-tizen-evaluation-20260918.3.zip)
ZIP mencakup `DRMXEvaluation.wgt`, layanan pendamping lokal Python dan skrip konfigurasi. [Unduh WGT unsigned secara terpisah](https://docs.drm-x.com/downloads/tizen/20260918.3/DRMXEvaluation.wgt) jika Anda sudah memiliki kitnya. ** WGT harus dikonfigurasi dan ditandatangani ulang untuk TV.** Ini adalah instalasi pengembang, bukan aplikasi Samsung Store atau penginstal satu klik universal.
- Samsung TV fisik yang kompatibel dan komputer pada LAN privat tepercaya yang sama.
- Python 3.12+, Tizen Studio, ekstensi Samsung TV dan Samsung Certificate Extension 2.0.73 atau lebih baru.
- Profil sertifikat Samsung TV yang berisi DUID perangkat Anda. Anda tidak memerlukan paket DRM-X berbayar untuk demo publik ini.
Ikuti panduan resmi Samsung [TV SDK instalasi](https://developer.samsung.com/smarttv/develop/getting-started/setting-up-sdk/installing-tv-sdk.html) dan [TV panduan sertifikat](https://developer.samsung.com/smarttv/develop/getting-started/setting-up-sdk/creating-certificates.html). Layar alat bervariasi berdasarkan versi.
Verifikasi unduhan publik
Perangkat evaluasi SHA-256:
```
379f72d32c80612c64cb235599661edf6862badf718500ac04f9d7e44ae22388
```
Tidak ditandatangani WGT SHA-256:
```
1682fb3b8615bf68acd74a2ac17ef793a6cc30ff682bdd917bb3a3035b0c084b
```
PowerShell: `Get-FileHash .\DRMXEvaluation.wgt -Algorithm SHA256`. Widget yang dikonfigurasi atau ditandatangani memiliki hash yang berbeda.
## 2. Pasangkan TV Anda dan buat sertifikatnya[#](#prepare-tv)
- **Aktifkan Developer Mode di TV.**Pada TV yang didukung, buka Apps dan masukkan 12345 untuk membuka Developer Mode. Aktifkan mode tersebut, masukkan LAN IP komputer Anda, lalu mulai ulang TV sesuai petunjuk. Ikuti [panduan perangkat TV](https://developer.samsung.com/smarttv/develop/getting-started/using-sdk/tv-device.html) dari Samsung jika model Anda berbeda.
- **Hubungkan TV.**Buka Tizen Studio Device Manager / Remote Device Manager. Tambahkan TV LAN IP dan sambungkan. Komputer harus dapat dijangkau dari TV itu; izinkan layanan pendamping lokal hanya di jaringan pribadi tepercaya.
- **Buat sertifikat Samsung TV.**Buka Certificate Manager → Add → Samsung → TV. Gunakan sertifikat penulis Anda dan sertifikat distributor yang berisi TV Anda DUID. Simpan kunci pribadi penulis di penyimpanan penandatanganan aman Anda.
- **Izin pemasangan.**Dalam Device Manager, pilih TV yang terhubung dan pilih **Permit to install applications** jika tersedia. Simpan nama profil sertifikat untuk perintah berikutnya.
## 3. Konfigurasikan, bangun dan instal[#](#install-evaluation)
Ekstrak evaluasi ZIP ke jalur pendek tanpa spasi. Buka terminal di sana. Gantikan dua placeholder dengan alamat pribadi LAN yang sebenarnya:
```
python configure-evaluation.py --computer-ip YOUR_COMPUTER_IP --tv-ip YOUR_TV_IP
```
**Biarkan terminal ini tetap berjalan.** Skrip membuat folder `app` dan memulai layanan pendamping lokal yang hanya menerima IP TV Anda serta otorisasi sementara yang baru. Layanan terhubung ke demo publik melalui HTTPS tanpa kredensial pelanggan. Masa berlakunya empat jam; jangan publikasikan widget yang sudah dikonfigurasi atau membuka port-nya ke Internet.
Buka terminal kedua di folder yang sama. Gunakan CLI executable dari instalasi Tizen Studio Anda, dan ganti profil sertifikat dan alamat TV:
```
tizen build-web -out .build -- app
tizen package -t wgt -s YOUR_SAMSUNG_PROFILE -- app/.build
sdb connect YOUR_TV_IP:26101
tizen install -n DRMXEvaluation.wgt -s YOUR_TV_IP:26101 -- app/.build
tizen run -p DrmXEval01.Player -s YOUR_TV_IP:26101
```
Pada Windows alatnya biasanya `tools\ide\bin\tizen.bat` dan `tools\sdb.exe` di dalam Tizen Studio. Jika perintah tidak ditemukan, gunakan jalur lengkapnya atau tambahkan folder tersebut ke terminal Anda PATH.
Setelah empat jam, hentikan layanan pendamping lokal. Jalankan kembali skrip konfigurasi dengan folder `--output app-new` baru, lalu build dan tanda tangani ulang folder itu. Otorisasi sementara akan berubah; jangan gunakan kembali konfigurasi terpasang yang sudah kedaluwarsa.
## 4. Coba VOD dan kendali jarak jauh[#](#test-playback)
Komposisi ilustrasi pemutaran. Cuplikan gambar video yang disediakan dan contoh subtitel telah ditambahkan ke antarmuka pemutar.
- Pilih judul VOD dengan Atas/Bawah dan tekan OK. Konfirmasikan video bergerak dan suara yang terdengar pada fisik TV.
- Pindah ke kanan ke kontrol. Coba jeda/lanjutkan, seek sebelumnya/berikutnya, ±10 detik, dan garis waktu.
- Coba Layar penuh. Back menutup menu atau keluar dari layar penuh sebelum menghentikan pemutaran. Volume tetap pada kendali jarak jauh normal TV.
- Periksa daftar putar, putar berikutnya, acak dan ulangi. Opsi audio/subtitel bergantung pada trek media sebenarnya.
- Hentikan pemutaran sebelum menutup layanan pendamping lokal. Entri langsung tetap tidak tersedia kecuali memenuhi syarat secara terpisah; kit ini tidak pernah memulai siaran.
Pendamping demo memilih set rendisi Full HD untuk Samsung Smart TV yang diuji tanpa mendekripsi atau mentranskode media. Kit publik ini tidak berisi media berhak cipta atau teks lagu eksternal. Hasil peralihan subtitle fisik menggunakan teks berlisensi yang disediakan secara terpisah; tambahkan trek Anda sendiri yang kompatibel saat menguji konten Anda.
## 5. Bangun aplikasi Anda sendiri dengan SDK[#](#quick-start)
- **Unduh Tizen SDK ZIP.**Buka [Console → Integrations](https://6.drm-x.com/console/integrations) dengan Professional aktif atau Enterprise organisasi. Baca `README.md`.
- **Gunakan sampel pemutar lengkap.**Salin `universal-player/` ke dalam TV aplikasi Web Anda. Edit `runtime-config.js`: atur HTTPS titik akhir sesi pemutaran Anda, yang dipublikasikan Content IDs dan callback autentikasi pemirsa.
- **Hubungkan backend Anda.**Autentikasi pemirsa, periksa hak akses, lalu kembalikan [Universal Playback Session Contract v1](https://docs.drm-x.com/id/api-reference/playback-sessions) dengan `widevine`, `dash`, `vod`, dan `streaming`. Dukung endpoint pelepasan sesinya. Klien menerima otorisasi token langsung atau melalui token proxy.
- **Konfigurasi akses jaringan.**Tambahkan backend, media, dan asal lisensi Anda yang sebenarnya ke `config.xml`. Konfigurasikan CORS layanan untuk asal TV jika diperlukan. Simpan Site Key dan Access Key secara eksklusif di backend.
- **Tanda tangani dengan identitas Anda.**Gunakan langkah build/pengemasan Tizen yang sama dengan input `universal-player`, nama file output `DRMXPlayer.wgt`, dan ID aplikasi contoh `DrmXSdk001.Player`. Gunakan pengenal sendiri sebelum mendistribusikan aplikasi.
Sampel meminta maksimum 1080p secara default. Backend Anda harus mengembalikan codec dan set rendisi yang dapat didekode oleh TV. Permintaan kemampuan ini tidak menulis ulang manifes UHD; lisensi dan kebijakan DRM tetap berlaku.
### Pertahankan antarmuka Anda sendiri
Muat Samsung `$WEBAPIS/webapis/webapis.js`, lalu `drmx-tizen.js`. Sertakan objek video asli dan pertahankan satu pemutar untuk layar:
```
```
```
const player = new DrmXTizen.Player({
endpoint: 'https://app.example.com/api/playback-session',
authentication: () => ({Authorization: 'Bearer ' + viewerToken}),
maximumHeight: 1080,
rect: {x:0, y:0, width:1920, height:1080},
onState: state => { statusLabel.textContent = state; }
});
await player.play('YOUR_PUBLISHED_CONTENT_ID');
player.pause();
player.resume();
player.seekTo(30000);
await player.stop();
await player.dispose(); // final dismissal or sign out
```
SDK mempertahankan byte challenge Widevine dan lisensi tanpa perubahan. SDK membatalkan pekerjaan pemutaran yang usang dan melepaskan sesi saat pemutar dihentikan, diganti, atau dihancurkan. Untuk WebVTT eksternal, sediakan metadata trek katalog serta callback `subtitle(contentId, trackId)` terotorisasi ke `UniversalPlayerService`. Lihat [AVPlay API](https://developer.samsung.com/smarttv/develop/api-references/samsung-product-api-references/avplay-api.html) Samsung untuk batasan media dan trek pada platform.
## Hasil pengujian perangkat dan pemecahan masalah[#](#qualification)
**Pengujian fisik:** Samsung Smart TV (Tizen), 17 September 2026. UI AVPlay lengkap dan layanan pendamping lokal memutar VOD terlindungi dalam Full HD dengan waktu pemutaran yang terus maju. Pemilihan subtitle eksternal Inggris/Mandarin dan pemutaran yang diperbaiki telah dikonfirmasi pada TV. Integrasi backend pelanggan yang dapat digunakan ulang baru tersedia dalam pratinjau SDK ini dan lulus pengujian otomatis. Validasi dengan backend dan perangkat fisik Anda sebelum produksi.
| Gejala | Periksa |
| --- | --- |
| Tidak dapat menginstal WGT | Gunakan sertifikat Samsung TV dengan TV ini DUID, aktifkan Developer Mode dan izinkan pemasangan. Publik WGT tidak ditandatangani. |
| Aplikasi mengatakan konfigurasi/koneksi gagal | Biarkan terminal layanan pendamping lokal tetap berjalan; periksa LAN IP, akses firewall jaringan pribadi, dan masa berlaku empat jam. Membangun kembali setelah konfigurasi ulang. |
| Layar hitam atau tersendat pada TV | Uji suara/kemajuan, codec, resolusi yang didukung, dan kebijakan HDCP. Gunakan rendition ladder FHD di Samsung Smart TV. Tangkapan layar hitam tidak sama dengan layar TV hitam. |
| Subtitle tidak tersedia | Menyediakan trek yang kompatibel. Peralihan jalur DASH TEXT melalui AVPlay secara sewenang-wenang tidak didukung; sampel mendukung WebVTT eksternal resmi. |
| Berfungsi di pratinjau desktop tetapi tidak TV | Pratinjau antarmuka di browser tidak menjalankan AVPlay atau Widevine. Uji pada TV fisik dan catat kode kesalahan tanpa informasi sensitif. |
Siaran langsung, unduhan offline, HDR, dan model Samsung lainnya belum diverifikasi pada rilis ini. Distribusi melalui toko aplikasi harus mengikuti proses sertifikasi dan pengajuan Samsung. [Bandingkan platform dan lihat semua tangkapan layar aplikasi →](https://docs.drm-x.com/id/sdk/native-apps)