Promowanie dodatku wśród użytkowników

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:

  1. Jeśli dodatek nie jest zainstalowany, pojawi się karta z prośbą o jego zainstalowanie.
  2. Jeśli dodatek jest już zainstalowany, przycisk przypomina użytkownikowi o jego otwarciu.

Udostępnianie ekranu

Promowanie dodatku przez 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.

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.