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

promowanie dodatku przez udostępnianie 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 rozpoczęcia przez użytkownika dodatku do aktywności w Meet od razu po uruchomieniu dodatku z banera prezentacji. Musi być ustawiona na wartość 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.

Jeśli Twój projekt korzysta z npm, możesz postępować zgodnie z instrukcjami dotyczącymi pakietu npm pakietu SDK dodatków Meet.

Najpierw zainstaluj pakiet npm:

npm install @googleworkspace/meet-addons

Następnie możesz zaimportować pakiet SDK dodatków Meet, aby korzystać z interfejsu MeetAddonScreenshareExport:

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

W przypadku użytkowników TypeScript definicje TypeScript są pakowane z modułem.

gstatic

Pakiet SDK dodatków Google Meet jest dostępny jako pakiet JavaScripta z gstatic, domeny, która udostępnia treści statyczne.

Aby korzystać z pakietu SDK dodatków Meet, dodaj do aplikacji ten tag skryptu:

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

Pakiet SDK dodatków Meet jest dostępny w interfejsie MeetAddon w sekcji window.meet.addon.

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ę, zobaczy 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 zostanie wyświetlona, użytkownikowi prezentującemu zostanie wyświetlony komunikat z prośbą o zainstalowanie lub skonfigurowanie dodatku.

Przykład: wczytywanie w głównym widoku

W tym przykładowym kodzie użytkownik, który udostępnia ekran z zawartą w nim stroną internetową w Meet, jest proszony 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ę, zobaczy 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 instalowanie lub uruchamianie 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ę, zobaczy 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 instalowanie lub uruchamianie dodatku.

Dopasowywanie punktu początkowego

Początki podane w mainStageUrl usługi i sidePanelUrl usługi są porównywane 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 inicjująca udostępnianie ekranu.

Więcej informacji znajdziesz w artykule Dodatkowe zabezpieczenia.