이 페이지에서는 측면 패널 iframe에서 실행되는 부가기능에서 기본 스테이지 iframe에서 실행되는 부가기능으로 클라이언트 측 메시지를 보내는 방법을 설명합니다. 프레임 간 메시지는 클라이언트 측에서만 발생하므로 메시지 전송이 거의 즉각적입니다.
메시지를 보내는 방법은 다음과 같습니다.
- 측면 패널에서 기본 스테이지로 이동하려면
notifyMainStage()메서드를 사용합니다.
await sidePanelClient.notifyMainStage("YOUR_MESSAGE");
- 기본 스테이지에서 측면 패널로 이동하려면
notifySidePanel()메서드를 사용합니다.
await mainStageClient.notifySidePanel("YOUR_MESSAGE");
payload 길이는 지정된 크기 제한을 준수해야 합니다.
메시지를 수신하려면 부가기능이 frameToFrameMessage 콜백을 구독해야 합니다. 다음 코드 샘플은 frameToFrameMessage 콜백을 구독하는 방법을 보여줍니다.
sidePanelClient.on('frameToFrameMessage', (arg: FrameToFrameMessage) => {
// YOUR_CODE
});
GitHub의 'Animation' 샘플 부가기능에는 프레임 간 메시지의 전체 예가 포함되어 있습니다. 활동이 시작되면 측면 패널은 사용자가 입력을 변경할 때마다 기본 스테이지에 알림을 보냅니다.
기본 스테이지는 업데이트된 상태를 수신하기 위해 frameToFrameMessage 콜백을 구독하기도 합니다.
참고
특정 참여자가 보낸 프레임 간 메시지는 해당 참여자에게만 표시됩니다. 다른 참여자에게 메시지나 상태를 보내려면 부가기능 상태를 공유하는 방법을 알아보세요.
메시지 전송은 한 번만 시도됩니다. 메시지를 수신하려면 수신 패널이 열려 있어야 하고 메시지가 전송되기 전에 앱이 콜백을 구독해야 합니다.