이 페이지에서는 클라이언트 측에서 측면 패널 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의 샘플 부가기능
에는 프레임 간 메시징의 전체 예가 포함되어 있습니다. 활동이 시작된 후
측면 패널에서 사용자가 입력을 변경할 때마다 기본 단계에 알림을 보냅니다.
기본 단계에서도 frameToFrameMessage 콜백을 구독합니다.
업데이트된 상태를 수신합니다.
참고
특정 참여자가 전송한 프레임 간 메시지는 참여자의 오직 공유할 수 있습니다. 다른 참가자에게 메시지나 상태를 보내려면 부가기능 공유 방법 알아보기 상태가 될 수 있습니다.
메시지 전송은 한 번만 시도됩니다. 메시지를 수신하기 위해 수신 패널이 열려 있어야 하고 앱에서 콜백을 구독해야 메시지가 전송됩니다.