클라이언트 객체 관리

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

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

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

CLOUD_PROJECT_NUMBER를 Google Cloud 프로젝트의 프로젝트 번호로 바꿉니다.

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

• await session.createMainStageClient()를 사용하여 검색할 수 있는 기본 단계에서 실행되는 부가기능의 MeetMainStageClient

• await session.createSidePanelClient()을 사용하여 검색할 수 있는 측면 패널에서 실행되는 부가기능의 MeetSidePanelClient

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

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

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

CLOUD_PROJECT_NUMBER를 Cloud 프로젝트의 프로젝트 번호로 바꿉니다.

공유 기능

일부 기능은 MeetMainStageClient 및 MeetSidePanelClient 객체 모두에서 사용할 수 있지만 다른 기능은 특정 클라이언트에만 해당합니다.

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

• 참여자가 활동에 참여하라는 초대를 수락할 때 애드온의 초기 상태에 관한 정보를 가져오는 getActivityStartingState() 메서드입니다.
• 부가기능이 실행 중인 회의에 관한 세부정보를 가져오는 getMeetingInfo() 메서드
• 참여자가 활동에 참여하라는 초대를 수락할 때 부가기능의 초기 상태를 설정하는 setActivityStartingState() 메서드
• 두 클라이언트의 기능 전체 목록은 MeetAddonClient 객체를 참고하세요.

클라이언트별 기능

MeetMainStageClient 객체에서만 사용할 수 있는 기능:

• notifySidePanel() 메서드는 측면 패널에 메시지를 전송합니다. 측면 패널에서 frameToFrameMessage 콜백을 구독하여 메시지를 수신할 수 있습니다.

• loadSidePanel() 메서드는 측면 패널 iframe을 엽니다. iframe 소스가 매니페스트 파일의 측면 패널 URL로 설정됩니다.

• unloadSidePanel() 메서드는 측면 패널 iframe을 닫습니다. 이 메서드가 호출되면 부가기능 상태가 Meet 내에 유지되지 않습니다. 이 메서드가 호출되기 전에 애드온 상태를 유지하는 것은 애드온의 몫입니다.

MeetSidePanelClient 객체에서만 사용할 수 있는 기능:

• notifyMainStage() 메서드는 mainStage에 메시지를 전송합니다. 메인 스테이지에서 frameToFrameMessage 콜백 속성을 구독하여 메시지를 수신할 수 있습니다.