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.
Coba demo PHP dengan mengikuti DEMO-QUICKSTART.md di dalam SDK ZIP. Untuk konten Anda sendiri, integrasikan situs web dan backend terlebih dahulu, lalu ikuti MOBILE-AND-TV-APPS.md untuk menghubungkan aplikasi ke sistem login dan aturan akses menonton yang sama.
1. Unduh perangkat evaluasi TV publik#
Unduh Samsung perangkat evaluasi ZIP
ZIP mencakup DRMXEvaluation.wgt, layanan pendamping lokal Python dan skrip konfigurasi. Unduh WGT unsigned secara terpisah 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 dan TV panduan sertifikat. Layar alat bervariasi berdasarkan versi.
Verifikasi unduhan publik
Perangkat evaluasi SHA-256:
0adbb09e72751a1934b94bcf7e59cb42f84b5822cba14f884ecb047b91bace9aTidak ditandatangani WGT SHA-256:
aa03536de098471e6f4870ebf668263ddd1799f1f091e3424197cd3b424df8f8PowerShell: Get-FileHash .\DRMXEvaluation.wgt -Algorithm SHA256. Widget yang dikonfigurasi atau ditandatangani memiliki hash yang berbeda.
2. Pasangkan TV Anda dan buat sertifikatnya#
- 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 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#
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#

- 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.
Layanan pendamping demo memilih versi Full HD tanpa mendekripsi atau mentranskode media. Tambahkan trek subtitel kompatibel milik Anda; kit publik tidak menyertakan subtitel eksternal.
5. Bangun aplikasi Anda sendiri dengan SDK#
- Unduh Tizen SDK ZIP.Buka Console → Developer Tools → Device SDKs dengan Professional aktif atau Enterprise organisasi. Baca
README.md. - Gunakan sampel pemutar lengkap.Salin
universal-player/ke dalam TV aplikasi Web Anda. Editruntime-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 dengan
widevine,dash,vod, danstreaming. 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 outputDRMXPlayer.wgt, dan ID aplikasi contohDrmXSdk001.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:
<object id="video" type="application/avplayer"></object>
<script src="$WEBAPIS/webapis/webapis.js"></script>
<script src="drmx-tizen.js"></script>
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 Samsung untuk batasan media dan trek pada platform.
Pemecahan masalah#
| 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. |
Publikasikan aplikasi Anda melalui proses sertifikasi dan pengajuan Samsung.
DRM-X 6.0