Na tej stronie opisujemy, jak promować dodatek użytkownikom podczas udostępniania ekranu karty w Google Meet przez umieszczenie niewielkiej ilości kodu na innej stronie internetowej.
Metoda MeetAddonScreenshare.exposeToMeetWhenScreensharing umożliwia witrynie wysyłanie informacji do Meet, gdy jej karta jest udostępniana. Te informacje będą używane w dodatku do Meet, gdy użytkownik kliknie „Rozpocznij aktywność” na banerze prezentacji, jeśli ma zainstalowany ten dodatek. Jeśli użytkownik nie ma zainstalowanego dodatku podczas udostępniania ekranu karty, zobaczy prośbę 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żywać do swojego inicjowania. Można ją ustawić tylko wtedy, gdy zasadaAddonScreenshareInfo.startActivityOnOpenma wartość prawda i można uzyskać do niej dostęp za pomocąCollaborationStartingState. Więcej informacji znajdziesz w artykule na temat używania stanu rozpoczęcia współpracy.AddonScreenshareInfo.cloudProjectNumber: Wymagane. Numer projektu Google Cloud dodatku.AddonScreenshareInfo.mainStageUrl: adres URL otwierający etap główny po uruchomieniu dodatku, np.https://www.example.com. Adres URL musi należeć do tej samej źródła 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 źródła co adresy URL określone w pliku manifestu dodatku.AddonScreenshareInfo.startActivityOnOpen: Wymagane. Określa, czy zacząć korzystać z dodatku do współpracy w Meet natychmiast po uruchomieniu dodatku przez użytkownika z banera prezentacji. Ta wartość musi mieć wartość prawda, jeśli używasz parametruAddonScreenshareInfo.mainStageUrl.
Przykład: ładowanie na scenie głównej
W tym przykładowym kodzie użytkownik, który udostępnia w Meet stronę internetową zawierającą ten kod, otrzymuje prośbę 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 udostępni stronę na ekranie połączenia w Meet, zobaczy baner prezentacji w Meet. Kliknięcie przycisku na banerze spowoduje otwarcie dodatku dla danego numeru projektu Cloud na etapie głównym. Obiekt AddonScreenshareInfo.mainStageUrl został wczytany, a AddonScreenshareInfo.additionalData służy do ustawiania stanu rozpoczęcia współpracy dodatku. Inni uczestnicy rozmowy zostaną natychmiast poproszeni o zainstalowanie lub uruchomienie dodatku.
Przykład: wczytywanie w panelu bocznym
W tym przykładowym kodzie użytkownik udostępnia stronę z dodatkiem, który chce się uruchamiać w panelu bocznym, a nie na scenie głównej:
<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 udostępni stronę na ekranie połączenia w Meet, zobaczy baner prezentacji w Meet. Kliknięcie przycisku na banerze spowoduje otwarcie w panelu bocznym dodatku o danym projekcie w chmurze. Obiekt AddonScreenshareInfo.sidePanelUrl został wczytany, a AddonScreenshareInfo.additionalData służy do ustawiania stanu rozpoczęcia współpracy dodatku. Inni 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 użytkownik udostępnia stronę z dodatkiem, który musi dostosować uprawnienia dotyczące zasobów przed rozpoczęciem współpracy. Ze względu na to wymaganie dodatek powinien uruchamiać się w panelu bocznym bez rozpoczynania współpracy 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 udostępni stronę na ekranie połączenia w Meet, zobaczy baner prezentacji w Meet. Kliknięcie przycisku na banerze spowoduje otwarcie w panelu bocznym dodatku o danym projekcie w chmurze. Parametr AddonScreenshareInfo.startActivityOnOpen ma wartość false (fałsz), więc przycisk rozpoczynania aktywności jest nieaktywny, dopóki nie zostanie ustawiony parametr CollaborationStartingState. Więcej informacji znajdziesz w artykule o używaniu stanu rozpoczęcia współpracy.
Po rozpoczęciu aktywności inni uczestnicy rozmowy zostaną poproszeni o uruchomienie lub zainstalowanie dodatku.
Dopasowanie źródła
Źródła podane w funkcjach AddonScreenshareInfo.mainStageUrl i AddonScreenshareInfo.sidePanelUrl są porównywane z źródłami w pliku manifestu dodatku dla podanego numeru projektu w chmurze. Jeśli wszystko się zgadza, użytkownik może uruchomić dodatek.
Dodatkowo w polu addOnOrigins w pliku manifestu dodatku musisz podać źródło witryny inicjującej udostępnianie ekranu.
Więcej informacji znajdziesz w artykule na temat zabezpieczeń dodatków.