Deweloperzy mogą zwiększyć widoczność swoich dodatków, promując je na czacie w trakcie spotkania w Meet i za pomocą funkcji udostępniania ekranu w Meet.
Czat podczas rozmowy
Dodatki do Google Meet są automatycznie promowane wśród użytkowników na czacie w trakcie rozmowy w Meet, gdy wiadomość zawiera linki powiązane z dodatkiem. Deweloper nie musi podejmować żadnych działań, aby promować dodatki na czacie. Zespół weryfikacyjny określa, które linki mają być powiązane z dodatkiem, na podstawie adresu URI panelu bocznego i źródeł dodatku ustawionych w pliku manifestu wdrożenia.
Gdy użytkownicy wysyłają wiadomość na czacie podczas połączenia powiązanego z dodatkiem, może się zdarzyć jedna z tych dwóch sytuacji:
- Jeśli dodatek nie jest zainstalowany, pojawi się karta z prośbą o jego zainstalowanie.
- Jeśli dodatek jest już zainstalowany, przycisk przypomina użytkownikowi o jego otwarciu.
Udostępnianie ekranu
Na tej stronie dowiesz się, jak promować dodatek wśród użytkowników podczas udostępniania ekranu karty w Google Meet, umieszczając niewielką ilość kodu na innej stronie internetowej.
Metoda
exposeToMeetWhenScreensharing()
umożliwia witrynie wysyłanie informacji 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 podczas udostępniania karty, zostanie poproszony o jego zainstalowanie.
Obiekt
AddonScreenshareInfo
zawiera 5 właściwości, które można dodać w zależności od przypadku użycia:
additionalData
: informacje, których dodatek może użyć do zainicjowania się. Można ją ustawić tylko wtedy, gdy właściwośćstartActivityOnOpen
ma wartość „true”. Dostęp do niej można uzyskać za pomocąActivityStartingState
. Więcej informacji znajdziesz w artykule Pobieranie stanu początkowego aktywności.cloudProjectNumber
: wymagane. Numer projektu Google Cloud.mainStageUrl
: Adres URL, który otwiera główny obszar po uruchomieniu dodatku, np.https://www.example.com
. Adres URL musi należeć do tego samego pochodzenia co adresy URL podane w pliku manifestu dodatku.sidePanelUrl
: adres URL, który otwiera się w panelu bocznym po uruchomieniu dodatku, np.https://www.example.com
. Adres URL musi należeć do tego samego pochodzenia co adresy URL podane w pliku manifestu dodatku.startActivityOnOpen
: wymagane. Określa, czy dodatek do aktywności ma być uruchamiany w Meet natychmiast po tym, jak użytkownik uruchomi go z banera prezentacji. Musi mieć wartość „true”, jeśli używana jest właściwośćmainStageUrl
.
Instalowanie i importowanie pakietu SDK
Dostęp do pakietu SDK możesz uzyskać za pomocą npm lub gstatic.
npm (zalecane)
Jeśli Twój projekt korzysta z npm, postępuj zgodnie z instrukcjami dotyczącymi pakietu SDK dodatków do Meet w npm.
Najpierw zainstaluj pakiet npm:
npm install @googleworkspace/meet-addons
Następnie pakiet SDK dodatków do Meet jest dostępny po zaimportowaniu interfejsu
MeetAddonScreenshareExport
:
import {meet} from '@googleworkspace/meet-addons/meet.addons.screenshare';
Użytkownicy TypeScriptu mają do dyspozycji definicje TypeScriptu spakowane z modułem.
Użytkownicy TypeScriptu powinni ustawić moduleResolution
na "bundler"
w tsconfig.json
projektu, aby specyfikacja „eksportów” w pliku package.json umożliwiła importowanie pakietu do udostępniania ekranu.
gstatic
Pakiet SDK dodatków do Google Meet jest dostępny jako pakiet JavaScript z gstatic
, czyli domeny, która udostępnia treści statyczne.
Aby użyć pakietu SDK dodatków do Meet, dodaj do aplikacji ten tag skryptu:
<script src="https://www.gstatic.com/meetjs/addons/1.1.0/meet.addons.screenshare.js"></script>
Pakiet SDK dodatków do Meet jest dostępny w interfejsie MeetAddon
w sekcji window.meet.addon
.
Przykład: wczytywanie w panelu bocznym bez rozpoczynania aktywności
W tym przykładowym kodzie użytkownik udostępnia ekran z dodatkiem, który musi dostosować uprawnienia do zasobów, zanim będzie można rozpocząć działanie. Z tego powodu dodatek powinien być uruchamiany w panelu bocznym, a nie w przypadku 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 Cloud.
- SIDE_PANEL_URL: ciąg znaków. Adres URL panelu bocznego.
Gdy użytkownik udostępni ekran podczas rozmowy w Meet, zobaczy w Meet baner prezentacji. Kliknięcie przycisku na banerze
otwiera dodatek dla danego numeru projektu w Google Cloud
w panelu bocznym. Ponieważ właściwość startActivityOnOpen
została ustawiona na wartość false, przycisk rozpoczęcia aktywności jest wyłączony do momentu ustawienia wartości ActivityStartingState
. Więcej informacji znajdziesz w artykule Korzystanie ze stanu początkowego aktywności.
Gdy aktywność się rozpocznie, inni użytkownicy biorący udział w połączeniu zobaczą prośbę o uruchomienie lub zainstalowanie dodatku.
Przykładowy dodatek „Animacja” na GitHubie zawiera ten przykład jako część pełnego dodatku. Gdy wyświetli się strona indeksu aplikacji internetowej powiązanej z dodatkiem, użytkownik, który ją wyświetla, zostanie poproszony o zainstalowanie lub skonfigurowanie dodatku.
Przykład: załadowanie w głównym widoku
W tym przykładzie kodu użytkownik, który udostępnia ekran z zawierającą go stroną internetową w Meet, jest proszony 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 Google Cloud.
- MAIN_STAGE_URL: ciąg znaków. Adres URL głównego widoku.
Gdy użytkownik udostępni ekran podczas rozmowy w Meet, zobaczy w Meet baner prezentacji. Kliknięcie przycisku na banerze spowoduje otwarcie dodatku dla danego numeru projektu w chmurze w głównej części ekranu. Właściwość mainStageUrl
jest wczytywana, a właściwość additionalData
służy do ustawiania stanu początkowego aktywności dodatku. Inni użytkownicy biorący udział w połączeniu od razu zobaczą prośbę o zainstalowanie lub uruchomienie dodatku.
Przykład: wczytywanie w panelu bocznym
W tym przykładzie kodu użytkownik udostępnia ekran z dodatkiem, który ma być uruchamiany w panelu bocznym, a nie na głównym obszarze:
<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 Cloud.
- SIDE_PANEL_URL: ciąg znaków. Adres URL panelu bocznego.
Gdy użytkownik udostępni ekran podczas rozmowy w Meet, zobaczy w Meet baner prezentacji. Kliknięcie przycisku na banerze
otwiera dodatek dla danego numeru projektu w Google Cloud
w panelu bocznym. Właściwość sidePanelUrl
jest wczytywana, a właściwość additionalData
służy do ustawiania stanu początkowego aktywności dodatku. Inni użytkownicy biorący udział w połączeniu od razu zobaczą prośbę o zainstalowanie lub uruchomienie dodatku.
Dopasowywanie źródła
Pochodzenia podane w usłudze mainStageUrl
i usłudze sidePanelUrl
są porównywane z pochodzeniami w pliku manifestu dodatku o podanym numerze projektu w chmurze. Jeśli wszystko się zgadza, użytkownik może uruchomić dodatek.
Dodatkowo w pliku manifestu dodatku w polu addOnOrigins
musi być podana domena witryny inicjującej udostępnianie ekranu.
Więcej informacji znajdziesz w artykule Zabezpieczenia dodatków.