클라이언트 객체 가져오기

이 페이지에서는 부가기능이 Google Meet과 통신하는 데 필요한 클라이언트 객체를 가져오는 방법을 설명합니다.

먼저 부가기능에서 세션을 설정해야 합니다.

  const session = await window.meet.addon.createAddonSession({
      cloudProjectNumber: "CLOUD_PROJECT_NUMBER",
    });

세션에서 두 개의 클라이언트 객체를 만들 수 있습니다.

기본 단계에서 실행되는 부가기능의 MeetMainStageClient이며 await session.createMainStageClient()를 사용하여 가져올 수 있습니다.
측면 패널에서 실행되는 부가기능의 MeetSidePanelClient이며 await session.createSidePanelClient()를 사용하여 가져올 수 있습니다.

기본 단계 또는 측면 패널에 대해 올바른 클라이언트 객체를 가져오는 것이 중요합니다. 잘못된 클라이언트를 가져오면 Google Meet 부가기능 SDK에서 예외가 발생합니다. 부가기능이 실행 중인 iframe (기본 단계 또는 측면 패널)을 확인하려면 MeetAddon.getFrameType 메서드를 사용하세요.

다음 코드 샘플은 기본 단계 클라이언트 객체를 인스턴스화하는 방법을 보여줍니다.

  const session = await window.meet.addon.createAddonSession({
      cloudProjectNumber: "CLOUD_PROJECT_NUMBER",
    });
  const mainStageClient = await session.createMainStageClient();

공유 기능

일부 기능은 MeetMainStageClient와 MeetSidePanelClient에서 모두 사용할 수 있지만, 다른 기능은 특정 클라이언트에만 사용할 수 있습니다.

예를 들어 두 클라이언트에서 모두 사용할 수 있는 기능은 다음과 같습니다.

참여자가 공동작업 초대를 수락했을 때 부가기능의 초기 상태에 관한 정보를 가져오는 MeetAddonClient.getCollaborationStartingState 메서드
부가기능이 실행되는 회의에 관한 세부정보를 가져오는 MeetAddonClient.getMeetingInfo 메서드
부가기능이 실행되는 회의 플랫폼에 관한 세부정보를 가져오는 MeetAddonClient.getMeetPlatformInfo 메서드
참여자가 공동작업 초대를 수락할 때 부가기능의 초기 상태를 설정하는 MeetAddonClient.setCollaborationStartingState입니다.
두 클라이언트의 전체 기능 목록은 MeetAddonClient 객체를 참조하세요.

클라이언트별 기능

MeetMainStageClient에서만 제공되는 기능:

MeetMainStageClient.notifySidePanel는 측면 패널에 메시지를 전송합니다. 측면 패널에서 frameToFrameMessage 콜백을 구독하여 메시지를 수신할 수 있습니다.
MeetMainStageClient.loadSidePanel 메서드는 측면 패널 iframe을 엽니다. iframe 소스는 매니페스트 파일의 측면 패널 URL로 설정됩니다.
MeetMainStageClient.unloadSidePanel 메서드는 측면 패널 iframe을 닫습니다. 메서드가 호출될 때 Meet 내에 부가기능 상태가 유지되지 않습니다. 이 메서드를 호출하기 전에 부가기능 상태를 유지하는 것은 부가기능의 책임입니다.

MeetSidePanelClient에서만 제공되는 기능:

MeetSidePanelClient.notifyMainStage는 mainStage에 메시지를 보냅니다. 메인스테이지에서 frameToFrameMessage 콜백을 구독하여 메시지를 수신할 수 있습니다.