DRM-X 6.0 dove dan logo cabang zaitunDRM-X 6.0Dokumentasi
◎ Bahasa Indonesia

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.

Lihat MarkdownContoh langsungUpdated 2026-09-21

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.

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#

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:

0adbb09e72751a1934b94bcf7e59cb42f84b5822cba14f884ecb047b91bace9a

Tidak ditandatangani WGT SHA-256:

aa03536de098471e6f4870ebf668263ddd1799f1f091e3424197cd3b424df8f8

PowerShell: Get-FileHash .\DRMXEvaluation.wgt -Algorithm SHA256. Widget yang dikonfigurasi atau ditandatangani memiliki hash yang berbeda.

2. Pasangkan TV Anda dan buat sertifikatnya#

  1. 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.
  2. 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.
  3. 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.
  4. 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#

Komposisi ilustrasi pemutaran. Cuplikan gambar video yang disediakan dan contoh subtitel telah ditambahkan ke antarmuka pemutar.
Komposisi ilustrasi pemutaran. Cuplikan gambar video yang disediakan dan contoh subtitel telah ditambahkan ke antarmuka pemutar.
  1. Pilih judul VOD dengan Atas/Bawah dan tekan OK. Konfirmasikan video bergerak dan suara yang terdengar pada fisik TV.
  2. Pindah ke kanan ke kontrol. Coba jeda/lanjutkan, seek sebelumnya/berikutnya, ±10 detik, dan garis waktu.
  3. Coba Layar penuh. Back menutup menu atau keluar dari layar penuh sebelum menghentikan pemutaran. Volume tetap pada kendali jarak jauh normal TV.
  4. Periksa daftar putar, putar berikutnya, acak dan ulangi. Opsi audio/subtitel bergantung pada trek media sebenarnya.
  5. 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#

  1. Unduh Tizen SDK ZIP.Buka Console → Developer Tools → Device SDKs dengan Professional aktif atau Enterprise organisasi. Baca README.md.
  2. 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.
  3. Hubungkan backend Anda.Autentikasi pemirsa, periksa hak akses, lalu kembalikan Universal Playback Session Contract v1 dengan widevine, dash, vod, dan streaming. Dukung endpoint pelepasan sesinya. Klien menerima otorisasi token langsung atau melalui token proxy.
  4. 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.
  5. 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:

<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#

GejalaPeriksa
Tidak dapat menginstal WGTGunakan sertifikat Samsung TV dengan TV ini DUID, aktifkan Developer Mode dan izinkan pemasangan. Publik WGT tidak ditandatangani.
Aplikasi mengatakan konfigurasi/koneksi gagalBiarkan 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 TVUji 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 tersediaMenyediakan 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 TVPratinjau 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.