Estados del reproductor
Los estados y las propiedades que describen qué está haciendo el reproductor
La mayoría de los errores de integración vienen de preguntarle algo al reproductor antes de que esté en condiciones de responder. Esta página describe los estados por los que pasa y las propiedades que los reportan.
Inicialización
El elemento del reproductor existe en tu DOM antes de que el reproductor detrás de él esté funcionando. Los métodos llamados en esa ventana pueden lanzar error, y las propiedades pueden devolver valores por defecto en vez de los reales — duration es 0 y conversionKey es una cadena vacía hasta que el vídeo carga.
La barrera es player:ready en el elemento personalizado, y iframe:connected en el iframe. Todo lo demás en esta página asume que ya la pasaste.
Leer el estado actual
Propiedad
Tipo
alreadyPlayed y paused responden preguntas distintas. paused es dónde está el vídeo ahora mismo; alreadyPlayed es si el visitante llegó a iniciarlo. Un vídeo que se reprodujo y luego se pausó reporta paused: true y alreadyPlayed: true.
Modos en los que puede estar el reproductor
Dos estados no hablan de la posición de reproducción, sino de cómo se inició el reproductor.
Propiedad
Tipo
SmartAutoPlay inicia el vídeo silenciado, porque los navegadores rechazan la reproducción automática con audio sin un gesto del usuario. El reproductor anuncia la transición con smartautoplay:active, y con smartautoplay:inactive en cuanto el vídeo se haya reproducido con audio — ya sea porque el visitante quitó el silencio o porque lo inició él mismo.
Estado de conversión
conversionKey codifica la sesión, el reproductor y la variante, cuánto se ha visto y qué variantes de función están activas. Es el valor que llevas a un checkout o a un formulario para atar la conversión a lo que el visitante realmente vio.
Devuelve una cadena vacía antes de que el reproductor esté listo, que es la forma más común de acabar vacío en producción. Mira Parámetros de conversión en URLs para llevarlo entre páginas.
Alcanzar un momento del vídeo
pitch:time se dispara cuando la reproducción alcanza el pitch time configurado para el reproductor en el panel — el momento en que se hace la oferta. Es el disparador habitual para revelar una llamada a la acción.
Para momentos arbitrarios, onTime y displayHiddenElements en la referencia de métodos hacen el mismo trabajo sin colgar un listener de cada video:timeupdate.