Cómo usar la función de mensajería de fotograma a fotograma

En esta página, se describe cómo enviar mensajes del cliente desde un complemento que se ejecuta en el iframe del panel lateral a un complemento que se ejecuta en el iframe del escenario principal. La mensajería de fotograma a fotograma solo se produce en el lado del cliente, por lo que la entrega de mensajes es casi instantánea.

Para enviar un mensaje, sigue estos pasos:

    await sidePanelClient.notifyMainStage("YOUR_MESSAGE");

    await mainStageClient.notifySidePanel("YOUR_MESSAGE");

La longitud de payload debe cumplir con el límite de tamaño especificado.

Para recibir el mensaje, el complemento debe suscribirse a la devolución de llamada frameToFrameMessage. En la siguiente muestra de código, se muestra cómo suscribirse a una devolución de llamada de frameToFrameMessage:

sidePanelClient.on('frameToFrameMessage', (arg: FrameToFrameMessage) => {
    // YOUR_CODE
});

El complemento de ejemplo"Animation" en GitHub incluye un ejemplo completo de los mensajes de fotogramas a fotogramas. Después de que se inicia la actividad, el panel lateral notifica al escenario principal cada vez que el usuario cambia una entrada. El escenario principal también se suscribe a la devolución de llamada de frameToFrameMessage para recibir el estado actualizado.

Notas

  • Los mensajes de fotograma a fotograma que envía un participante determinado solo los puede ver ese mismo participante. Para enviar mensajes o estados a otros participantes, obtén información sobre cómo compartir el estado del complemento.

  • Solo se intenta entregar el mensaje una vez. Para recibir mensajes, el panel receptor debe estar abierto y la app debe suscribirse a la devolución de llamada antes de que se envíe el mensaje.