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 zasadaAddonScreenshareInfo.startActivityOnOpen
ma wartość prawda i jest dostępny za pomocą funkcjiCollaborationStartingState
. 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 parametrAddonScreenshareInfo.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.