클라이언트 객체 관리

이 페이지에서는 부가기능이 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 객체에서만 사용할 수 있는 기능: