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

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

Powiązane artykuły

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