На этой странице описано, как получить объект клиента, который необходим надстройке для связи с Google Meet.
Сначала надстройке необходимо установить сеанс:
const session = await window.meet.addon.createAddonSession({
cloudProjectNumber: "CLOUD_PROJECT_NUMBER",
});
Из сеанса можно создать два клиентских объекта:
MeetMainStageClient
для надстройки, работающей на основной сцене , которую можно получить с помощьюawait session.createMainStageClient()
.MeetSidePanelClient
для надстройки, работающей на боковой панели , которую можно получить с помощьюawait session.createSidePanelClient()
.
Важно получить правильный клиентский объект для основной сцены или боковой панели. Если получен неправильный клиент, SDK надстроек Google Meet выдает исключение. Чтобы проверить, в каком 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 на главной сцене.