공동작업 시작 상태 사용

이 페이지에서는 CollaborationStartingState의 용도와 Google Meet 부가기능 SDK에서 이를 설정하고 검색하는 방법을 설명합니다.

공동작업 시작 상태의 개요

부가기능이 처음 열리면 측면 패널 iframe에서 부가기능 매니페스트에 지정된 URL을 로드합니다. 이 초기 상태는 사용자가 공동작업 초대를 사용하여 참여할 때 부가기능에서 사용하려는 시작 상태와 다를 수 있습니다. CollaborationStartingState는 사용자가 공동작업 초대를 사용하여 참여할 때 로드해야 하는 iframe URL을 지정하는 데 사용할 수 있습니다. 또한 부가기능에서 additional_data 필드를 활용하여 초기화에 필요할 수 있는 모든 데이터를 저장할 수 있습니다.

공동작업 시작 상태 설정, 가져오기, 삭제

다음 메서드를 사용하여 CollaborationStartingState를 관리할 수 있습니다.

MeetAddonClient.setCollaborationStartingState 메서드를 사용하여 CollaborationStartingState를 설정합니다.

MeetAddonClient.setCollaborationStartingState 메서드에 지정된 URL은 부가기능 매니페스트에 지정된 출처와 동일한 출처에 속해야 합니다. 자세한 내용은 부가기능 보안을 참조하세요.

sidePanelUrl, mainStageUrl, additionalData 길이는 SDK 참조 문서에 게시된 각각의 크기 제한을 준수해야 합니다.

    mainStageClient.setCollaborationStartingState({
        sidePanelUrl: "https://app.example.com/sidepanel",
        mainStageUrl: "https://app.example.com/mainstage",
        additionalData: JSON.stringify({
        // State to send to participants.
        })
    });

MeetAddonClient.getCollaborationStartingState 메서드를 사용하여 CollaborationStartingState를 가져옵니다.

    const startingState = mainStageClient.getCollaborationStartingState();
    const additionalData = JSON.parse(startingState.additionalData);

MeetAddonClient.clearCollaborationStartingState 메서드를 사용하여 CollaborationStartingState를 삭제합니다.

    mainStageClient.clearCollaborationStartingState();