Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
SDK del reproductor de Amazon IVS
Para utilizar Amazon Interactive Video Service (IVS), debe utilizar el reproductor de Amazon IVS. El reproductor es un conjunto multiplataforma de SDK para la reproducción de transmisiones de Amazon IVS. Está diseñado a fin de aprovechar la arquitectura de Amazon IVS y optimizado para la reproducción de Amazon IVS.
Solo podemos garantizar el rendimiento del reproductor de Amazon IVS. Para lograr una latencia baja, se requiere el reproductor de Amazon IVS.
Las características clave del reproductor de Amazon IVS son:
-
ltra-low-latency Transmisión en U: la baja latencia es un componente fundamental para crear buenas experiencias de usuario interactivas que enriquezcan la experiencia de la audiencia. La latencia se mueve progresivamente a lo largo de la ruta de transmisión entre la emisora y el espectador, lo que debilita la capacidad de respuesta.
La nd-to-end latencia electrónica es el tiempo transcurrido desde que la cámara captura una transmisión en directo hasta que aparece en la pantalla del espectador. Amazon IVS está diseñado para ofrecer una end-to-end latencia ultrabaja (menos de cinco segundos, según la ubicación de la transmisión y la configuración de la emisora). Para lograr esta latencia baja, se requiere el reproductor de Amazon IVS.
-
Consistencia multiplataforma: los espectadores ven las transmisiones en una variedad de plataformas. Desde dispositivos móviles hasta navegadores web, el reproductor de Amazon IVS ofrece una experiencia similar a todos los espectadores. Esta coherencia es posible porque cada plataforma utiliza la misma biblioteca de funciones del reproductor. La biblioteca del reproductor es un componente integral de la arquitectura de Amazon IVS. El uso de una pila de video garantiza que todos los comportamientos de reproducción de video, incluidos el modo de latencia baja, los metadatos cronometrados, los análisis, el seguimiento de errores, los informes y el registro, estén disponibles de forma coherente en todas las plataformas compatibles.
-
Transmisión de velocidad de bits adaptable (ABR): el reproductor de Amazon IVS utiliza algoritmos de ABR optimizados para entornos de latencia baja. El reproductor mide la calidad del servicio y la disponibilidad del ancho de banda en tiempo real y adapta la calidad de video y los niveles de búfer, para proporcionar una reproducción ininterrumpida. Cuando la calidad de la conexión se ve afectada, ABR cambia a una tasa de bits más baja; cuando la calidad de la conexión mejora, cambia a una tasa de bits más alta.
-
Metadatos cronometrados: el reproductor de Amazon IVS es compatible con metadatos cronometrados, que se pueden utilizar para crear elementos interactivos como encuestas y cuestionarios. Los metadatos son un conjunto de datos que describen y proporcionan información sobre otros datos. Con metadatos “cronometrados”, un código de tiempo acompaña a los datos sobre la transmisión. Durante la reproducción, el código de tiempo sirve como punto de referencia para activar una acción en función de los datos, como:
-
Envío de estadísticas de jugadores para una transmisión deportiva
-
Envío de detalles del producto para una transmisión de compras en directo
-
Envío de preguntas para una transmisión de preguntas en directo
-
-
Gestión robusta de errores: gestionar errores transitorios evita interrupciones en la experiencia de visualización. La gestión robusta de errores del reproductor de Amazon IVS detecta muchos errores de transmisión posibles y cambia a una ejecución alternativa de forma automática. Los espectadores siguen viendo la transmisión ininterrumpida, sin tener que tomar medidas correctivas.
-
Facilidad de integración: la API del reproductor de Amazon IVS reduce la brecha entre las aplicaciones de los clientes de Amazon IVS y la biblioteca del reproductor. La API tiene enlaces para todas las plataformas compatibles, lo que facilita la integración del reproductor en las aplicaciones, mientras utiliza entornos y técnicas de codificación familiares. Con un control total sobre los elementos de la interfaz de usuario, los clientes pueden personalizar los aspectos de marca y presentación de sus aplicaciones.
El reproductor de Amazon IVS no admite la transmisión con Airplay. La transmisión con Chromecast se puede implementar fuera del reproductor utilizando las aplicaciones del receptor Chromecast predeterminadas. Sin embargo, la latencia de esas aplicaciones es mayor que en el SDK del reproductor de Amazon IVS, por lo que el cambio no será perfecto. Consulte también nuestra documentación sobre el SDK de transmisión de Amazon IVS: para transmisión de baja latencia y transmisión en tiempo real.
Requisitos de navegador y plataforma
Para obtener más información sobre las versiones más recientes de varios navegadores, consulte:
Aunque Amazon IVS puede funcionar con algunos navegadores de versiones anteriores, no solucionamos errores relacionados con dichas versiones de navegadores.
El SDK del reproductor web de IVS (incluidas las integraciones Video.js y Player JW) no se admite en entornos similares a los de los navegadores. Esto incluye dispositivos nativos WebViews y «dispositivos de 10 pies» (televisores, consolas, decodificadores) que admiten aplicaciones web. Póngase en contacto con Soporte de IVS si no está seguro de la compatibilidad con navegadores específicos fuera de las tablas que se indican a continuación.
Navegadores de escritorio
| Navegador de escritorio | Plataformas admitidas | Versiones compatibles |
|---|---|---|
| Chrome | Windows, macOS | Dos versiones principales (la versión actual y la anterior más reciente) |
| Firefox | Windows, macOS | Dos versiones principales (la versión actual y la anterior más reciente) |
| Ubicaciones | Windows 8.1 y posteriores | 44.0 y versiones posteriores (En el modo de calidad automática en Microsoft Edge Legacy |
| Safari | macOS | Dos versiones principales (la versión actual y la anterior más reciente) (En el modo de calidad automática en Safari para macOS 14 y versiones posteriores, el reproductor de IVS 1.3.0 y versiones posteriores admite la reproducción de latencia ultrabaja. Para versiones anteriores de Safari y IVS Player, solo se admite la reproducción con latencia normal. Consulte más arriba para ver el “modo de calidad automática”). |
Navegadores en dispositivos móviles
| Navegador en dispositivos móviles | Versiones compatibles |
|---|---|
| Chrome para iOS, Safari para iOS | Dos versiones principales (la versión actual y la anterior más reciente) (No se admite la reproducción de latencia ultrabaja. Se admite la reproducción de latencia normal. Esta restricción se aplica a todos los navegadores para iOS.) (Solo se admiten los metadatos cronometrados en la versión 1.3.0 y posteriores del reproductor). |
| Chrome para iPadOS, Safari para iPadOS | Dos versiones principales (la versión actual y la anterior más reciente) (Cuando se selecciona “Solicitar sitio web móvil”:
|
| Chrome para Android | Dos versiones principales (la versión actual y la anterior más reciente) |
Plataformas nativas
| Plataforma | Versiones compatibles | Dispositivos admitidos |
|---|---|---|
| Android | Versión 5.0 (Lollipop) y posteriores | Teléfonos y tabletas |
| iOS | 12.0 y versiones posteriores | Todos |
IVS admite un mínimo de 4 versiones principales de iOS y 6 versiones principales de Android. El soporte de nuestra versión actual se puede extender más allá de estos mínimos. Los clientes recibirán una notificación mediante las notas de lanzamiento del SDK con al menos 3 meses de antelación cuando una versión principal deje de ser compatible.
Reducción de la latencia en los reproductores de terceros
Para los tipos de canal básico y estándar: si desea conseguir la menor latencia posible, debe utilizar el reproductor de Amazon IVS. En los reproductores de terceros (incluido Safari en iOS), puede reducir la latencia a cerca de 10 segundos con la siguiente configuración:
-
Establezca el intervalo de fotogramas clave del codificador (p. ej., OBS) en 2 segundos o menos.
-
Agregue
?keyframeInterval=2a la URL de RTMP(S). Por ejemplo:rtmps://a1b2c3d4e5f6.global-contribute.live-video.net:443/app/sk_us-west-2_abcd1234efgh5678ijkl?keyframeInterval=2
Nota: El intervalo de fotogramas clave especificado como parte de la URL de RTMP debe ser mayor o igual al valor configurado en el codificador; de lo contrario, es posible que tenga problemas de reproducción. Puede establecer el valor en cualquier número entero entre 2 y 6 inclusive, pero 2 habilita la latencia más baja.
Para tipos de canal avanzado: las instrucciones anteriores no se aplican. Los tipos de canales avanzados generan automáticamente intervalos de fotogramas clave para una codificación eficiente, con un intervalo máximo de 2 segundos entre fotogramas clave, independientemente de la configuración del intervalo de fotogramas clave de codificación de origen.
Safari para iOS
En Safari para iOS, puede reducir la latencia a aproximadamente 6 a 8 segundos utilizando el reproductor IVS y configurándolo para que utilice un trabajador de servicio. Consulte Configurar un trabajador de servicio en el SDK del reproductor: Guía web para obtener detalles sobre la implementación y un ejemplo de referencia.
Nota: Para obtener la latencia más baja se requiere una transmisión de IVS con un intervalo de fotogramas clave establecido en 2 segundos.
Reproducción solo de audio
Todos los tipos de canales IVS admiten reproducciones únicamente de audio. Esto puede resultar especialmente útil para las aplicaciones móviles. Por ejemplo, en su aplicación móvil, puede cambiar el reproductor a la versión de solo audio cuando el usuario coloque la aplicación en segundo plano para ahorrar ancho de banda.
En el caso de los canales ADVANCED-SD y ADVANCED-HD, la reproducción de solo audio se incluye automáticamente en la lista de reproducción multivariante. En el caso de los canales BÁSICO y ESTÁNDAR, debe añadir el parámetro de ?allow_audio_only=true consulta a la URL de reproducción para poder incluir la variante de solo audio.
Nota: El SDK del reproductor web IVS solo admite la reproducción de audio en las versiones 1.24.0 y posteriores.
Soporte
Si encuentra un error u otro problema de reproducción en su transmisión, determine el identificador único de sesión de reproducción a través de la API del reproductor.
| Para este reproductor de Amazon IVS: | Utilice esto: |
|---|---|
| Android | Función |
| iOS | Propiedad |
| Web | Función |
Comparta este identificador de sesión de reproducción con AWS Support. Con él, pueden obtener información para ayudar a solucionar el problema.
Nota: El reproductor se mejora de forma continua. Consulte Notas de la versión de Amazon IVS para ver las versiones disponibles y los problemas solucionados. Si procede, antes de contactar con el soporte técnico, actualice su versión del reproductor y compruebe si se resuelve el problema.
Control de versiones
Los SDK del reproductor de Amazon IVS utilizan el control de versiones semántico
Para este análisis, suponga:
-
La última versión es la 4.1.3.
-
La última versión de la versión principal anterior es la 3.2.4.
-
La última versión de la versión 1.x es la 1.5.6.
Las características nuevas compatibles con versiones anteriores se agregan como versiones secundarias de la última versión. En este caso, el siguiente conjunto de características nuevas se agregará como la versión 4.2.0.
Se agregan correcciones de errores menores compatibles con versiones anteriores como parches de la última versión. Aquí, el siguiente conjunto de correcciones de errores menores se agregará como la versión 4.1.4.
Las correcciones de errores principales compatibles con versiones anteriores se manejan de manera diferente; estas se agregan a varias versiones:
-
Versión del parche de la última versión. Aquí, esta es la versión 4.1.4.
-
Versión del parche de la versión secundaria anterior. Aquí, esta es la versión 3.2.5.
-
Versión del parche de la última versión 1.x. Aquí, esta es la versión 1.5.7.
El equipo de productos de Amazon IVS define las principales correcciones de errores. Las actualizaciones de seguridad críticas y otras correcciones seleccionadas necesarias para los clientes son ejemplos típicos.
Nota: En los ejemplos anteriores, las versiones publicadas aumentan sin omitir ningún número (por ejemplo, de 4.1.3 a 4.1.4). En realidad, uno o más números de parche pueden permanecer internos y no ser lanzados, por lo que la versión publicada podría aumentar de 4.1.3 a 4.1.6.
