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

Promowanie dodatku na ekranie udostępnianie.

Na tej stronie dowiesz się, jak promować dodatek wśród użytkowników podczas udostępniania ekranu karty w Google Meet przez umieszczenie niewielkiej ilości kodu na innej stronie.

exposeToMeetWhenScreensharing() umożliwia witrynie wysyłanie informacji do Meet podczas udostępniania ekranu karty. Te informacje są używane w jako dodatku do Meet, gdy użytkownik klika „Rozpocznij aktywność” na banerze prezentacji, jeśli mają Dodatek zainstalowany. Jeśli użytkownik nie ma podczas udostępniania karty pojawi się prośba o zainstalowanie dodatku.

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ę. 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 Używanie stanu początkowego aktywności.

  • cloudProjectNumber: wymagane. Numer projektu Google Cloud.

  • mainStageUrl: Adres URL, który otwiera się w fazie głównej po zainstalowaniu dodatku zaczyna się, na przykład 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 się w panelu bocznym po zainstalowaniu dodatku zaczyna się, na przykład https://www.example.com. Adres URL musi należeć do tego samego origin jako adresów URL podanych w parametrze pliku manifestu dodatku.

  • startActivityOnOpen: Wymagana. Określa, czy uruchomić dodatek do aktywności w Meet natychmiast, gdy użytkownik uruchomi na banerze prezentacji. Musi być ustawiona na wartość Prawda, jeśli używasz właściwości mainStageUrl.

Przykład: wczytywanie na etapie głównym

W poniższym przykładowym kodzie użytkownik, który udostępnia stronę internetową w W Meet, który zawiera ten kod, pojawia się prośba o uruchomienie dodatek:

<script src="https://www.gstatic.com/meetjs/addons/1.0.0/meet.addons.screenshare.js"></script>
<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 głównego widoku.

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 główną scenę. została wczytana właściwość mainStageUrl, a Właściwość additionalData służy do ustawiania aktywności rozpoczynającej się stan 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 src="https://www.gstatic.com/meetjs/addons/1.0.0/meet.addons.screenshare.js"></script>
<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 Twojego Projekt w chmurze.
  • 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. Właściwość sidePanelUrl jest wczytana, a właściwość additionalData służy do ustawienia stanu początkowego dodatku. Pozostali uczestnicy rozmowy pojawi się prośba o zainstalowanie lub uruchomienie dodatku.

Przykład: wczytywanie w panelu bocznym bez rozpoczynania działania

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 src="https://www.gstatic.com/meetjs/addons/1.0.0/meet.addons.screenshare.js"></script>
<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 Twojego Projekt w chmurze.
  • SIDE_PANEL_URL: ciąg znaków. Adres URL panelu bocznego.

Gdy użytkownik na ekranie rozmowy w Meet udostępnia stronę, widzi baner prezentacji w Meet. kliknięcie przycisku na banerze, otwiera dodatek do projektu Cloud o danym numerze w w panelu bocznym. Ponieważ startActivityOnOpen ma wartość false (fałsz), przycisk Rozpocznij aktywność będzie wyłączony, dopóki Ustawienie ActivityStartingState jest ustawione. Więcej informacji znajdziesz w sekcji Używanie aktywności początkowym.

Po rozpoczęciu aktywności pozostali uczestnicy rozmowy są proszeni o podczas uruchamiania lub instalowania 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.

Musisz też podać pochodzenie witryny, która inicjuje udostępnianie ekranu, w polu addOnOrigins w dodatku pliku manifestu.

Więcej informacji znajdziesz w artykule Dodatek zabezpieczeń.