# Samsung Tizen SDK y TV evaluación
Instale el reproductor de evaluación Samsung TV, configure y firme su WGT, luego integre el Widevine VOD con el Tizen Universal Player SDK.
**Samsung TV utiliza una aplicación web Tizen.** Esta guía cubre Widevine DASH VOD con Samsung AVPlay. Utilice el kit de evaluación pública para probar el reproductor o el Professional/Enterprise SDK para conectar su propio backend.
## 1. Descargar el kit de evaluación público TV[#](#try-tv-app)
[Descargar Samsung kit de evaluación ZIP](https://docs.drm-x.com/downloads/tizen/20260918.3/drmx-tizen-evaluation-20260918.3.zip)
El ZIP incluye `DRMXEvaluation.wgt`, un servicio auxiliar local Python y el script de configuración. [Descarga el WGT por separado](https://docs.drm-x.com/downloads/tizen/20260918.3/DRMXEvaluation.wgt) sin firmar si ya tienes el kit. **El WGT debe configurarse y volver a firmarse para su TV.** Es una instalación para desarrolladores, no una aplicación de la Tienda Samsung ni un instalador universal con un solo clic.
- Un Samsung TV físico compatible y un ordenador en la misma LAN privada de confianza.
- Python 3.12+, Tizen Studio, la extensión Samsung TV y Samsung Certificate Extension 2.0.73 o posterior.
- Un perfil de certificado Samsung TV que contiene el DUID de su dispositivo. No necesita un plan pago DRM-X para esta demostración pública.
Siga las guías oficiales de Samsung para [instalar TV SDK](https://developer.samsung.com/smarttv/develop/getting-started/setting-up-sdk/installing-tv-sdk.html) y [crear el certificado TV](https://developer.samsung.com/smarttv/develop/getting-started/setting-up-sdk/creating-certificates.html). Las pantallas varían según la versión.
Verificar las descargas públicas
Kit de evaluación SHA-256:
```
379f72d32c80612c64cb235599661edf6862badf718500ac04f9d7e44ae22388
```
Sin firmar WGT SHA-256:
```
1682fb3b8615bf68acd74a2ac17ef793a6cc30ff682bdd917bb3a3035b0c084b
```
PowerShell: `Get-FileHash .\DRMXEvaluation.wgt -Algorithm SHA256`. Un widget configurado o firmado tiene un hash diferente.
## 2. Empareja tu TV y crea su certificado[#](#prepare-tv)
- **Habilite Developer Mode en TV.**En televisores compatibles, abra las aplicaciones, ingrese 12345 para abrir Developer Mode, enciéndalo, ingrese el LAN IP de su computadora y reinicie el TV como se indica. Siga la guía del dispositivo [TV](https://developer.samsung.com/smarttv/develop/getting-started/using-sdk/tv-device.html) de Samsung si su modelo es diferente.
- **Conectar el TV.**Abrir Tizen Studio Device Manager / Remote Device Manager. Agregue los TV LAN IP y conéctese. La computadora debe ser accesible desde ese TV; permitir el servicio auxiliar local sólo en la red privada de confianza.
- **Crear un certificado Samsung TV.**Abrir Certificate Manager → Add → Samsung → TV. Utilice su certificado de autor y un certificado de distribuidor que contenga su TV DUID. Mantenga la clave privada del autor en su propio almacenamiento de firma seguro.
- **Permitir instalación.**En Device Manager, seleccione el TV conectado y elija **Permit to install applications** cuando esté disponible. Mantenga el nombre del perfil del certificado para los siguientes comandos.
## 3. Configurar, construir e instalar[#](#install-evaluation)
Extrae la evaluación ZIP a un camino corto sin espacios. Abra una terminal allí. Reemplace los dos marcadores de posición con las direcciones privadas LAN reales:
```
python configure-evaluation.py --computer-ip YOUR_COMPUTER_IP --tv-ip YOUR_TV_IP
```
**Mantenga este terminal en ejecución.** El script crea la carpeta `app` e inicia un servicio auxiliar local limitado a la IP de su TV y a una nueva autorización temporal. Se conecta a la demo pública mediante HTTPS sin sus credenciales de cliente. Caduca tras cuatro horas; no publique el widget configurado ni exponga su puerto a Internet.
Abra una segunda terminal en la misma carpeta. Utilice los ejecutables CLI de su instalación Tizen Studio y reemplace el perfil del certificado y la dirección 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
```
En Windows las herramientas suelen estar `tools\ide\bin\tizen.bat` y `tools\sdb.exe` dentro de Tizen Studio. Si no se encuentra un comando, use su ruta completa o agregue esa carpeta a su terminal PATH.
Tras cuatro horas, detenga el servicio auxiliar local, vuelva a ejecutar el script de configuración con una carpeta `--output app-new` nueva y compile y firme de nuevo esa carpeta. Cambia la autorización temporal; no reutilice la configuración instalada que ya haya caducado.
## 4. Pruebe VOD y los controles remotos[#](#test-playback)
Composición ilustrativa de reproducción. Se han añadido a la interfaz del reproductor un fotograma proporcionado y un subtítulo de ejemplo.
- Elija un título VOD con Arriba/Abajo y presione OK. Confirme el video en movimiento y el sonido audible en el TV físico.
- Mover hacia la derecha a los controles. Pruebe pausar/reanudar, anterior/siguiente, desplazamiento en la línea de tiempo de ±10 segundos y la línea de tiempo.
- Pruebe en pantalla completa. Back cierra un menú o sale de la pantalla completa antes de detener la reproducción. El volumen permanece en los controles remotos normales del TV.
- Verificar lista de reproducción, reproducir a continuación, reproducir aleatoriamente y repetir. Las opciones de audio/subtítulos dependen de las pistas multimedia reales.
- Detenga la reproducción antes de cerrar el servicio auxiliar local. Las entradas en vivo no están disponibles a menos que califiquen por separado; Este kit nunca inicia una transmisión.
El servicio auxiliar local de demostración selecciona un conjunto de representación Full HD para el Samsung Smart TV probado sin descifrar ni transcodificar medios. Este kit público no contiene medios con derechos de autor ni subtítulos de canciones externos. El resultado del cambio de subtítulos físicos utilizó subtítulos con licencia suministrados por separado; agregue sus propias pistas compatibles cuando pruebe su contenido.
## 5. Crea tu propia aplicación con el SDK[#](#quick-start)
- **Descargar el Tizen SDK ZIP.**Abrir [Console → Integrations](https://6.drm-x.com/console/integrations) con un Professional activo o Enterprise organización. Leer `README.md`.
- **Utilice la muestra completa del reproductor.**Copie `universal-player/` en su aplicación web TV. Editar `runtime-config.js`: configura tu HTTPS punto final de la sesión de reproducción, publicado Content IDs y la devolución de llamada de autenticación del espectador.
- **Conecte su backend.**Autentique al espectador, compruebe sus derechos y devuelva [Universal Playback Session Contract v1](https://docs.drm-x.com/es/api-reference/playback-sessions) con `widevine`, `dash`, `vod` y `streaming`. Implemente también su endpoint de liberación de sesión. El cliente acepta autenticación mediante token directo o proxy de tokens.
- **Configurar el acceso a la red.**Agregue sus orígenes reales de backend, medios y licencias a `config.xml`. Configure el CORS de los servicios para el origen TV cuando sea necesario. Mantenga Site Key y Access Key exclusivamente en el backend.
- **Firma con tu identidad.**Utiliza los mismos Tizen pasos de compilación/paquete con `universal-player` como entrada, `DRMXPlayer.wgt` como nombre de archivo de salida y `DrmXSdk001.Player` como aplicación de muestra ID. Utilice sus propios identificadores antes de distribuir su aplicación.
La muestra solicita un máximo de 1080p de forma predeterminada. Su backend debe devolver un códec y el conjunto de representación TV puede decodificar. Esta solicitud de capacidad no reescribe un manifiesto UHD; la licencia y la política DRM siguen teniendo autoridad.
### Mantenga su propia interfaz
Cargue Samsung, `$WEBAPIS/webapis/webapis.js`, luego `drmx-tizen.js`. Incluya el objeto de vídeo nativo y conserve un reproductor para la pantalla:
```
```
```
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
```
El SDK conserva intactos los bytes de la solicitud Widevine y de la licencia. Cancela operaciones de reproducción obsoletas y libera las sesiones al detener, sustituir o destruir el reproductor. Para WebVTT externo, proporcione los metadatos de las pistas del catálogo y un callback `subtitle(contentId, trackId)` autorizado a `UniversalPlayerService`. Consulte [AVPlay API](https://developer.samsung.com/smarttv/develop/api-references/samsung-product-api-references/avplay-api.html) de Samsung para las restricciones de medios y pistas de cada plataforma.
## Resultados de la prueba del dispositivo y solución de problemas[#](#qualification)
**Prueba física:** Samsung Smart TV (Tizen), 17 de septiembre de 2026. La UI completa de AVPlay y el servicio auxiliar local reprodujeron VOD protegido en Full HD con avance del reloj. Se confirmaron en el TV la selección de subtítulos externos inglés/chino y la reproducción corregida. La integración reutilizable con el backend del cliente es nueva en esta versión preliminar del SDK y supera pruebas automatizadas. Valídela con su backend y sus dispositivos físicos antes de usarla en producción.
| Síntoma | Verificar |
| --- | --- |
| No se puede instalar WGT | Utilice un certificado Samsung TV con este DUID de TV, habilite Developer Mode y permita la instalación. El público WGT no está firmado. |
| La aplicación dice error de configuración/conexión | Mantener en funcionamiento el terminal complementario; verifique ambas LAN IP, el acceso al firewall de la red privada y el vencimiento de cuatro horas. Reconstruir después de la reconfiguración. |
| Pantalla negra o reproducción entrecortada en el TV | Prueba de sonido/progreso, códec, resolución admitida y política HDCP. Utilice una escalera de FHD en el Samsung Smart TV. No es lo mismo una captura de pantalla en negro que una pantalla TV en negro. |
| Subtítulos no disponibles | Suministro de pistas compatibles. No se admite el cambio arbitrario de pistas DASH TEXT a través de AVPlay; la muestra admite externos autorizados WebVTT. |
| Funciona en la vista previa del escritorio pero no TV | La vista previa de la interfaz en el navegador no ejecuta AVPlay ni Widevine. Pruebe en un TV físico y registre un código de error sin información confidencial. |
El directo, las descargas sin conexión, HDR y otros modelos Samsung todavía no se han validado con esta versión. La distribución en la tienda requiere el proceso de certificación y envío de Samsung. [Compare las plataformas y vea todas las capturas →](https://docs.drm-x.com/es/sdk/native-apps)