Meet 부가기능을 사용하여 공동작업하기

회의 참여자는 Google Meet 부가기능 활동에서 공동작업할 수 있습니다. 공동작업 활동이 시작되면 회의의 모든 참여자에게 활동이 진행 중이라는 알림이 전송됩니다.

이 알림은 부가기능의 사용 가능 여부 및 설치 상태에 따라 조정됩니다.

  • 참여자가 부가기능을 설치한 경우: 활동에 참여할 수 있습니다.

  • 참석자에게 부가기능이 설치되어 있지 않은 경우: 부가기능을 설치하라는 메시지가 표시됩니다.

  • 참여자의 플랫폼에서 부가기능을 사용할 수 없는 경우: 현재 기기를 사용하여 활동에 참여할 수 없다는 알림이 표시됩니다.

사용자가 활동에 참여하면 부가기능 콘텐츠가 포함된 자체 iframe을 로드합니다. 새로 참여하는 사용자가 기본 단계 또는 측면 패널에서 공동작업 활동을 열어야 하는지 맞춤설정할 수 있습니다.

활동 시작

활동은 ActivityStartingState 인터페이스를 사용하는 startActivity() 메서드를 호출하여 시작됩니다.

1단계 (선택사항): 부가기능에서 활동 시작 상태 설정

ActivityStartingState에는 참여자가 활동 참여 초대를 수락할 때 사용되는 부가기능의 초기 상태에 관한 정보가 포함됩니다.

부가기능은 활동 전이나 활동 중에 언제든지 setActivityStartingState() 메서드를 호출하여 ActivityStartingState를 설정하거나 업데이트할 수 있습니다. ActivityStartingState가 startActivity() 호출에서만 설정된 경우 setActivityStartingState() 호출을 생략할 수 있습니다.

2단계: 부가기능에서 활동 시작하기

부가기능이 MeetSidePanelClient에서 startActivity() 메서드를 호출하면 활동이 시작됩니다. startActivity() 메서드는 ActivityStartingState 객체를 매개변수로 사용하므로 setActivityStartingState()를 호출하는 대신 startActivity()를 호출할 수 있습니다.

사용자가 콘텐츠 선택을 완료하고 활동을 시작할 준비가 되면 다음과 같이 부가기능에서 startActivity() 메서드를 호출합니다.

    sidePanelClient.startActivity({
        mainStageUrl: "https://app.example.com/mainstage",
        additionalData: JSON.stringify({
            // State to send to participants.
        })
    });

startActivity() 메서드가 호출되면 Meet은 다음 작업을 실행합니다.

  • 다른 참여자: Meet에 활동이 진행 중이라는 알림이 표시됩니다.

  • 시작하는 사용자: ActivityStartingState에 기본 스테이지 URL이 지정된 경우 Meet은 ActivityStartingState의 URL을 사용하여 기본 스테이지를 엽니다.

3단계: 활동 시작 상태 가져오기

사용자가 활동에 참여하면 ActivityStartingState에 따라 부가기능을 기본 단계 또는 측면 패널에 로드합니다.

additionalData 속성을 사용하면 활동에 참여하는 사용자와 초기 데이터 (상태라고도 함)를 공유할 수 있습니다. MainStageClient 또는 SidePanelClient를 초기화한 후 getActivityStartingState() 메서드를 호출하여 additionalData 속성을 가져올 수 있습니다.

const startingState = client.getActivityStartingState();
const additionalData = JSON.parse(startingState.additionalData);

4단계 (선택사항): 활동에서 부가기능 상태 공유

자체 동기화 백엔드를 작성하여 활동이 진행되는 동안 사용자 간에 상태를 공유할 수도 있습니다.

예: GitHub의 애니메이션 부가기능

GitHub의 '애니메이션' 샘플 부가기능에는 부가기능의 공동작업이 포함되어 있습니다. 이 가이드의 1단계는 샘플에 포함되어 있지 않습니다. 대신 부가기능 시작자가 측면 패널에서 '애니메이션 시작' 버튼을 클릭하면 사용자가 선택한 색상으로 시작 상태를 채워 startActivity() 메서드가 호출됩니다 (2단계). 활동이 시작되면 기본 단계는 getActivityStartingState() 메서드를 호출하여 시작 상태를 검색합니다(3단계). 이 샘플 부가기능의 활동 중에는 참여자 간에 상태 (선택한 색상)가 공유되지 않으므로 4단계는 생략됩니다. 하지만 개별 사용자는 색상을 선택하여 자신의 상태를 변경할 수 있으며, 이 색상은 프레임 간 메시지를 사용하여 측면 패널 프레임에서 기본 스테이지 프레임으로 전송됩니다.

제약조건