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

Z tej strony dowiesz się, jak promować dodatek wśród użytkowników, gdy udostępniasz ekran karty w Google Meet, umieszczając niewielką ilość kodu na innej stronie internetowej.

Metoda MeetAddonScreenshare.exposeToMeetWhenScreensharing umożliwia witrynie wysyłanie informacji do Meet, gdy udostępniasz ekran jej karty. Te informacje są używane w dodatku do Meet po kliknięciu przez użytkownika „Rozpocznij aktywność” na banerze prezentacji (jeśli ma zainstalowany dodatek). Jeśli użytkownik nie ma zainstalowanego dodatku podczas udostępniania ekranu karty, zostanie poproszony o jego zainstalowanie.

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

• AddonScreenshareInfo.additionalData: informacje, których dodatek może użyć do inicjowania się. Można go ustawić tylko wtedy, gdy zasada AddonScreenshareInfo.startActivityOnOpen ma wartość prawda i jest dostępny za pomocą funkcji CollaborationStartingState. Więcej informacji znajdziesz w sekcji Używanie stanu początkowego współpracy.

• AddonScreenshareInfo.cloudProjectNumber: wymagane. Numer projektu Google Cloud dodatku.

• AddonScreenshareInfo.mainStageUrl: adres URL otwierany przez scenę główną po uruchomieniu dodatku, np. https://www.example.com. Adres URL musi należeć do tej samej wartości origin co adresy URL określone w pliku manifestu dodatku.

• AddonScreenshareInfo.sidePanelUrl: adres URL otwierany w panelu bocznym po uruchomieniu dodatku, np. https://www.example.com. Adres URL musi należeć do tej samej wartości origin co adresy URL określone w pliku manifestu dodatku.

• AddonScreenshareInfo.startActivityOnOpen: wymagane. Określa, czy dodatek ma zostać uruchomiony w Meet, gdy użytkownik uruchomi dodatek na banerze prezentacji. Jeśli jest używany parametr AddonScreenshareInfo.mainStageUrl, musi mieć wartość prawda.

Przykład: wczytywanie na etapie głównym

W tym przykładowym kodzie użytkownik, który udostępnia w Meet stronę internetową zawierającą ten kod, jest proszona o uruchomienie dodatku:

<script src="https://www.gstatic.com/meetjs/addons/0.7.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 Twojego projektu w chmurze.
• MAIN_STAGE_URL: ciąg znaków. Adres URL sceny głównej.

Gdy użytkownik na ekranie połączenia w Meet udostępni stronę, zobaczy w Meet baner prezentacji. Kliknięcie przycisku na banerze otwiera dodatek dla danego numeru projektu Cloud na etapie głównym. Interfejs AddonScreenshareInfo.mainStageUrl został wczytany, a element AddonScreenshareInfo.additionalData służy do ustawienia początkowego stanu współpracy dodatku. Pozostali uczestnicy rozmowy zostaną natychmiast poproszeni o zainstalowanie lub uruchomienie dodatku.

Przykład: Wczytywanie w panelu bocznym

W poniższym przykładowym kodzie ekran użytkownika udostępnia stronę z dodatkiem, który chce się uruchamiać w panelu bocznym, a nie w głównej części:

<script src="https://www.gstatic.com/meetjs/addons/0.7.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 Twojego projektu 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 w Meet baner prezentacji. Kliknięcie przycisku na banerze otwiera dodatek dla danego numeru projektu Cloud w panelu bocznym. Interfejs AddonScreenshareInfo.sidePanelUrl został wczytany, a element AddonScreenshareInfo.additionalData służy do ustawienia początkowego stanu współpracy dodatku. Pozostali uczestnicy rozmowy zostaną natychmiast poproszeni o zainstalowanie lub uruchomienie dodatku.

Przykład: wczytywanie w panelu bocznym bez rozpoczynania współpracy

W poniższym przykładowym kodzie ekran użytkownika udostępnia stronę z dodatkiem, który musi dostosować uprawnienia do zasobów, zanim rozpocznie się aktywność związana ze współpracą. Ze względu na to wymaganie należy uruchamiać dodatek w panelu bocznym, a nie u wszystkich użytkowników.

<script src="https://www.gstatic.com/meetjs/addons/0.7.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 Twojego projektu 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 w Meet baner prezentacji. Kliknięcie przycisku na banerze otwiera dodatek dla danego numeru projektu Cloud w panelu bocznym. Wartość AddonScreenshareInfo.startActivityOnOpen ma wartość Fałsz, więc przycisk rozpoczęcia działania będzie wyłączony, dopóki nie ustawisz CollaborationStartingState. Więcej informacji znajdziesz w sekcji Używanie stanu początkowego współpracy.

Po uruchomieniu aktywności inni użytkownicy rozmowy zostaną poproszeni o uruchomienie lub zainstalowanie dodatku.

Dopasowywanie punktu początkowego

Źródła podane w AddonScreenshareInfo.mainStageUrl i AddonScreenshareInfo.sidePanelUrl są porównywane z punktami początkowymi w pliku manifestu dodatku podanego numeru projektu w chmurze. Jeśli wszystko będzie działać, użytkownik może uruchomić dodatek.

Dodatkowo w polu addOnOrigins w manifeście dodatku musi być podane pochodzenie witryny, która inicjuje udostępnianie ekranu.

Więcej informacji znajdziesz w artykule Zabezpieczenia dodatków.

Powiązane artykuły

• Używanie stanu początkowego współpracy
• Dodatkowe zabezpieczenia