Используйте начальное состояние действия,Используйте начальное состояние действия

На этой странице описывается назначение ActivityStartingState , а также способы его установки и получения из SDK надстроек Google Meet.

Обзор начального состояния активности

При первом открытии надстройки iframe на боковой панели загружает URL-адрес, указанный в манифесте надстройки . Это начальное состояние может отличаться от начального состояния, которое надстройка хочет использовать, когда пользователи присоединяются с помощью приглашения на действие. ActivityStartingState можно использовать для указания URL-адресов iframe, которые должны загружаться, когда пользователи присоединяются с помощью приглашения на действие. Кроме того, свойство additional_data может использоваться надстройкой для хранения любых данных, которые могут потребоваться для ее инициализации.

Установите и получите начальное состояние активности

Вы можете управлять состоянием начала действия с помощью следующих методов.

Набор

Чтобы установить или обновить информацию о ActivityStartingState , используйте метод setActivityStartingState() . Надстройка может установить начальное состояние в любое время до или во время занятия.

URL-адреса, указанные в методе setActivityStartingState() должны принадлежать тому же источнику , что и источники, указанные в манифесте надстройки . Дополнительную информацию см. в разделе Дополнительная безопасность .

Длина символов свойства sidePanelUrl , свойства mainStageUrl и свойства additionalData должна соответствовать соответствующим ограничениям на размер, опубликованным в справочной документации SDK.

    mainStageClient.setActivityStartingState({
        sidePanelUrl: "https://app.example.com/sidepanel",
        mainStageUrl: "https://app.example.com/mainstage",
        additionalData: JSON.stringify({
        // State to send to participants.
        })
    });

Получать

Для получения информации о ActivityStartingState используйте метод getActivityStartingState() .

    const startingState = mainStageClient.getActivityStartingState();
    const additionalData = JSON.parse(startingState.additionalData);