클라이언트 객체 관리

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

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

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

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

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

기본 스테이지 또는 측면 패널에 맞는 올바른 클라이언트 객체를 검색하는 것이 중요합니다. 잘못된 클라이언트가 검색되면 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 객체에서만 사용할 수 있는 기능: