promować dodatek wśród użytkowników za pomocą udostępniania ekranu.

Na tej stronie opisano, jak promować dodatek wśród użytkowników podczas udostępniania ekranu w Google Meet, umieszczając niewielką ilość kodu na innej stronie internetowej.

Metoda exposeToMeetWhenScreensharing() pozwala witrynie wysyłać informacje do Meet, gdy jej karta jest udostępniana. Te informacje są używane w dodatku w Meet, gdy użytkownik kliknie „Rozpocznij aktywność” na banerze prezentacji, jeśli ma zainstalowany dodatek. Jeśli użytkownik nie ma zainstalowanego dodatku, a chce udostępnić ekran na karcie, zostanie poproszony o jego zainstalowanie.

Obiekt AddonScreenshareInfo zawiera 5 właściwości, które można dodać w zależności od przypadku użycia:

• additionalData: informacje, których wtyczka może używać do inicjowania. Można ją ustawić tylko wtedy, gdy właściwość startActivityOnOpen ma wartość Prawda i można uzyskać do niej dostęp za pomocą właściwości ActivityStartingState. Więcej informacji znajdziesz w artykule Początek aktywności.

• cloudProjectNumber: wymagane. Numer projektu Google Cloud.

• mainStageUrl: adres URL, pod którym otwiera się główna scena po uruchomieniu dodatku, np. https://www.example.com. Adres URL musi należeć do tego samego źródła co adresy URL określone w pliku manifestu dodatku.

• sidePanelUrl: adres URL, który otwiera panel boczny po uruchomieniu dodatku, np. https://www.example.com. Adres URL musi należeć do tego samego źródła co adresy URL określone w pliku manifestu dodatku.

• startActivityOnOpen: wymagane. Określa, czy w przypadku uruchomienia przez użytkownika dodatku z banera prezentacji dodatkowy element aktywności w Meet ma się rozpocząć od razu. Musi być zdefiniowana jako Prawda, jeśli używasz właściwości mainStageUrl.

Instalowanie i importowanie pakietu SDK

Dostęp do pakietu SDK możesz uzyskać za pomocą npm lub gstatic.

npm install @googleworkspace/meet-addons

import {meet} from '@googleworkspace/meet-addons/meet.addons.screenshare';

<script src="https://www.gstatic.com/meetjs/addons/1.1.0/meet.addons.screenshare.js"></script>

Przykład: wczytywanie w panelu bocznym bez uruchamiania aktywności

W tym przykładowym kodzie ekran użytkownika udostępnia stronę z dodatkiem, który musi dostosować uprawnienia zasobów, zanim będzie można rozpocząć aktywność. Z tego powodu wtyczka powinna być uruchamiana w panelu bocznym, bez uruchamiania aktywności dla wszystkich.

<script>
meet.addon.screensharing.exposeToMeetWhenScreensharing(
  {
    cloudProjectNumber: CLOUD_PROJECT_NUMBER,
    startActivityOnOpen: false,
    sidePanelUrl: SIDE_PANEL_URL,
  }
);
</script>

Zastąp następujące elementy:

• CLOUD_PROJECT_NUMBER: ciąg znaków. Numer projektu Google Cloud.
• SIDE_PANEL_URL: ciąg znaków. Adres URL panelu bocznego.

Gdy użytkownik na ekranie połączenia w Meet udostępnia stronę, widzi baner prezentacji w Meet. Kliknięcie przycisku na banerze powoduje otwarcie w panelu bocznym dodatku dla danego numeru projektu w chmurze. Ponieważ atrybut startActivityOnOpen został ustawiony na wartość fałsz, przycisk rozpoczęcia aktywności jest wyłączony, dopóki nie ustawisz wartości ActivityStartingState. Więcej informacji znajdziesz w artykule Używanie stanu początkowego aktywności.

Po rozpoczęciu aktywności inni użytkownicy w połączeniu otrzymają prośbę o uruchomienie lub zainstalowanie dodatku.

Przykładowy dodatek „Animation” na GitHubie zawiera ten przykład jako część pełnego dodatku. Gdy strona indeksu aplikacji internetowej powiązanej z dodatkiem jest wyświetlana, użytkownik prezentujący proszony jest o zainstalowanie lub skonfigurowanie dodatku.

Przykład: wczytywanie w głównym widoku

W tym przykładowym kodzie użytkownik, który udostępnia ekran strony internetowej w Google Meet zawierającej ten kod, otrzyma prośbę o uruchomienie dodatku:

<script>
meet.addon.screensharing.exposeToMeetWhenScreensharing(
  {
    cloudProjectNumber: CLOUD_PROJECT_NUMBER,
    startActivityOnOpen: true,
    mainStageUrl: MAIN_STAGE_URL,
    additionalData: "{\"selected_item\": \"42\"}",
  }
);
</script>

Zastąp następujące elementy:

• CLOUD_PROJECT_NUMBER: ciąg znaków. Numer projektu Google Cloud.
• MAIN_STAGE_URL: ciąg znaków. Adres URL głównego widoku.

Gdy użytkownik na ekranie połączenia w Meet udostępnia stronę, widzi baner prezentacji w Meet. Kliknięcie przycisku na banerze powoduje otwarcie w głównej części ekranu dodatku dla danego projektu w chmurze. Właściwość mainStageUrl jest wczytana, a właściwość additionalData służy do ustawienia stanu początkowego aktywności dodatku. Pozostali użytkownicy w połączeniu natychmiast otrzymają prośbę o zainstalowanie lub uruchomienie dodatku.

Przykład: wczytywanie w panelu bocznym

W tym przykładzie kodu ekran użytkownika zawiera stronę z dodatkiem, który ma się uruchamiać w panelu bocznym, a nie na głównym etapie:

<script>
meet.addon.screensharing.exposeToMeetWhenScreensharing(
  {
    cloudProjectNumber: CLOUD_PROJECT_NUMBER,
    startActivityOnOpen: true,
    sidePanelUrl: SIDE_PANEL_URL,
    additionalData: "{\"selected_item\": \"42\"}",
  }
);
</script>

Zastąp następujące elementy:

• CLOUD_PROJECT_NUMBER: ciąg znaków. Numer projektu Google Cloud.
• SIDE_PANEL_URL: ciąg znaków. Adres URL panelu bocznego.

Gdy użytkownik na ekranie połączenia w Meet udostępnia stronę, widzi baner prezentacji w Meet. Kliknięcie przycisku na banerze powoduje otwarcie w panelu bocznym dodatku dla danego numeru projektu w chmurze. Właściwość sidePanelUrl jest wczytana, a właściwość additionalData służy do ustawienia stanu początkowego aktywności dodatku. Pozostali użytkownicy w połączeniu natychmiast otrzymają prośbę o zainstalowanie lub uruchomienie dodatku.

Dopasowywanie punktu początkowego

Początki podane w usługach mainStageUrl i sidePanelUrl porównywane są z początkami w pliku manifestu dodatku o podanym numerze projektu w chmurze. Jeśli wszystko się zgadza, użytkownik może uruchomić dodatek.

Dodatkowo w polu addOnOrigins w pliku manifestu dodatku musi być podana witryna, z której pochodzi strona, na której rozpoczęto udostępnianie ekranu.

Więcej informacji znajdziesz w artykule Dodatkowe zabezpieczenia.

Powiązane artykuły

• Współpraca przy użyciu dodatku do Meet
• Zabezpieczenia dodatku