На этой странице описывается, как управлять клиентскими объектами, которые необходимы надстройке для связи с Google Meet.
Сначала надстройке необходимо установить сеанс:
const session = await window.meet.addon.createAddonSession({
cloudProjectNumber: "CLOUD_PROJECT_NUMBER",
});
Замените CLOUD_PROJECT_NUMBER на номер вашего проекта Google Cloud.
Из сеанса можно создать два клиентских объекта:
MeetMainStageClient
для надстройки, работающей на основной сцене , которую можно получить с помощьюawait session.createMainStageClient()
.MeetSidePanelClient
для надстройки, работающей на боковой панели , которую можно получить с помощьюawait session.createSidePanelClient()
.
Важно получить правильный клиентский объект для основной сцены или боковой панели. Если получен неправильный клиент, SDK надстроек Google Meet выдает исключение. Чтобы проверить, в каком iframe (основная сцена или боковая панель) работает надстройка, используйте метод getFrameType()
.
В следующем примере кода показано, как создать экземпляр клиентского объекта основной стадии:
const session = await window.meet.addon.createAddonSession({
cloudProjectNumber: "CLOUD_PROJECT_NUMBER"
});
const mainStageClient = await session.createMainStageClient();
Замените CLOUD_PROJECT_NUMBER на номер вашего облачного проекта.
Общие функции
Некоторые функции доступны как в объекте MeetMainStageClient
, так и в объекте MeetSidePanelClient
, тогда как другие функции специфичны для определенного клиента.
Например, некоторые функции, доступные в обоих клиентах, включают:
- Метод
getActivityStartingState()
, который получает информацию о начальном состоянии надстройки, когда участник принимает приглашение присоединиться к активности. - Метод
getMeetingInfo()
, который получает сведения о собрании, на котором работает надстройка. - Метод
setActivityStartingState()
, который устанавливает начальное состояние дополнения, когда участник принимает приглашение присоединиться к действию. - Полный список функций обоих клиентов см. в объекте
MeetAddonClient
.
Особенности клиента
Функции, доступные только в объекте MeetMainStageClient
:
Метод
notifySidePanel()
отправляет сообщение на боковую панель. Сообщение можно получить, подписавшись на обратныйframeToFrameMessage
на боковой панели.Метод
loadSidePanel()
открывает iframe боковой панели. В качестве источника iframe задан URL-адрес боковой панели из файла манифеста.Метод
unloadSidePanel()
закрывает iframe боковой панели. Состояние надстройки не сохраняется в Meet при вызове метода. Надстройка должна сохранять любое состояние надстройки до вызова этого метода.
Функции, доступные только в объекте MeetSidePanelClient
:
- Метод
notifyMainStage()
отправляет сообщение в mainStage. Сообщение можно получить, подписавшись на свойство обратногоframeToFrameMessage
в основной сцене.