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 do 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.

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

  • additionalData: Informacje, których dodatek może używać do inicjowania się. Puszka być ustawiana tylko wtedy, gdy właściwość startActivityOnOpen ma wartość true (prawda) i może być dostęp za pomocą ActivityStartingState Więcej informacji znajdziesz w artykule Początek aktywności.

  • cloudProjectNumber: Wymagana. Numer projektu Google Cloud.

  • mainStageUrl: adres URL, który otwiera się na scenie głównej po uruchomieniu dodatku, np. https://www.example.com. Adres URL musi należeć do tego samego origin jako adresów URL podanych w parametrze 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: Wymagana. 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 mieć wartość prawda jeśli używana jest właściwość mainStageUrl.

.

Instalowanie i importowanie pakietu SDK

Możesz uzyskać dostęp do pakietu SDK przy użyciu npm lub gstatic.

Jeśli Twój projekt używa npm, możesz wykonać instrukcje dotyczące Pakiet npm pakietu npm dodatku do Meet.

Najpierw zainstaluj pakiet npm:

npm install @googleworkspace/meet-addons

Następnie możesz zaimportować pakiet SDK dodatków Meet, korzystając 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 do Google Meet jest dostępny jako Pakiet JavaScriptu z domeny gstatic, 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 poniższym przykładowym kodzie ekran użytkownika udostępnia stronę , który musi dostosować uprawnienia do zasobów przed można rozpocząć aktywność. Ze względu na to wymaganie dodatek należy uruchamiać w panelu bocznym, bez dla wszystkich użytkowników.

<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ępni stronę, zobaczy baner prezentacji w Meet. kliknięcie przycisku na banerze, otwiera dodatek do projektu Cloud o danym numerze w w panelu bocznym. 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. Kiedy stronę indeksu, aplikacji internetowej powiązanej z dodatkiem zostanie wyświetlona, osoba prezentująca zostanie poproszona o zainstalowanie lub skonfigurowanie Google Analytics.

Przykład: wczytywanie w głównym widoku

W tym przykładowym kodzie użytkownik, który udostępnia ekran z witryną w Meet zawierającą 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 w Google Cloud.
  • MAIN_STAGE_URL: ciąg znaków. Adres URL sceny głównej.

Gdy użytkownik na ekranie połączenia w Meet udostępnia stronę, zobaczy baner prezentacji w Meet. kliknięcie przycisku na banerze, otwiera dodatek do projektu Cloud o danym numerze w główną scenę. Właściwość mainStageUrl jest wczytana, a właściwość additionalData służy do ustawienia stanu początkowego aktywności dodatku. Pozostali uczestnicy rozmowy pojawi się prośba o zainstalowanie lub uruchomienie dodatku.

Przykład: wczytywanie w panelu bocznym

W poniższym przykładowym kodzie ekran użytkownika udostępnia stronę który chce uruchomić się w panelu bocznym, niż główna:

<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ępni stronę, zobaczy baner prezentacji w Meet. Kliknięcie przycisku na banerze powoduje otwarcie w panelu bocznym dodatku dla danego numeru projektu Cloud. została wczytana właściwość sidePanelUrl, a Właściwość additionalData służy do ustawiania aktywności rozpoczynającej się stan dodatku. Pozostali użytkownicy w połączeniu natychmiast otrzymają prośbę o zainstalowanie lub uruchomienie 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, na której rozpoczęto udostępnianie ekranu.

Więcej informacji znajdziesz w artykule Dodatek zabezpieczeń.