Współpraca przy użyciu dodatku Meet

Uczestnicy spotkania mogą wspólnie pracować nad aktywnością dodatku Google Meet. Gdy rozpocznie się wspólne działanie, Wszyscy uczestnicy spotkania otrzymają powiadomienie, że aktywność jest w toku.

To powiadomienie jest dostosowane do dostępności i stanu instalacji dodatku:

  • Jeśli uczestnik ma zainstalowany dodatek: Może dołączyć do aktywności.

  • Jeśli uczestnik nie ma dodatku zainstalowano: użytkownik zostaje skierowany do zainstalowania Google Analytics.

  • Jeśli dodatek nie jest dostępny platforma uczestnika: użytkownik zostanie poinformowany, że nie może dołączyć do aktywności. przy użyciu obecnego urządzenia.

Gdy użytkownik dołączy do aktywności, wczyta własne elementy iframe z Twoim treści dodatkowe. Możesz określić, czy nowi uczestnicy mają otwierać wspólną aktywność w głównej części ekranu czy w panelu bocznym.

Rozpocznij aktywność

Aktywność jest uruchamiana przez wywołanie metody startActivity(), która korzysta z interfejsu ActivityStartingState.

Krok 1 (opcjonalny): dodatek ustawia stan początkowy aktywności

ActivityStartingState zawiera informacje o początkowym stanie używany, gdy uczestnik zaakceptuje zaproszenie do dołączenia do aktywności.

Dodatek może ustawiać lub aktualizować ActivityStartingState, wywołując setActivityStartingState() w dowolnym momencie przed lub w trakcie aktywności. Połączenia z: Parametr setActivityStartingState() można pominąć, jeśli pole ActivityStartingState ma wartość ustawiony wyłącznie w wywołaniu funkcji startActivity().

Krok 2. Dodatek rozpoczyna aktywność

Aktywność rozpoczyna się, gdy dodatek wywoła metodę startActivity() w obiekcie MeetSidePanelClient. Metoda startActivity() przyjmuje jako parametr obiekt ActivityStartingState, więc zamiast wywoływać setActivityStartingState(), można wywołać startActivity().

Gdy użytkownik zakończy wybór treści i będzie gotowy do rozpoczęcia aktywności, wywołaj metodę startActivity() w swojej wtyczce w ten sposób:

    sidePanelClient.startActivity({
        mainStageUrl: "https://app.example.com/mainstage",
        additionalData: JSON.stringify({
            // State to send to participants.
        })
    });

Po wywołaniu metody startActivity() Meet wykonuje następujące działania:

  • Inni uczestnicy: Meet wyświetla powiadomienie, które aktywność jest w toku.

  • Dla inicjatora: jeśli adres URL etapu głównego został określony w parametrze ActivityStartingState, Meet otwiera scenę główną za pomocą adres URL z tagu ActivityStartingState.

Krok 3. Pobierz stan początkowy aktywności

Gdy użytkownik dołączy do aktywności, wczyta Twój dodatek do głównej sceny lub panelu bocznego w zależności od ActivityStartingState.

Dzięki właściwości additionalData możesz udostępniać dane początkowe (nazywane też stanem) użytkownikom dołączającym do aktywności. Po zainicjowaniu MainStageClient lub SidePanelClient, Ty może wywołać metodę getActivityStartingState() metody pobierania właściwości additionalData.

const startingState = client.getActivityStartingState();
const additionalData = JSON.parse(startingState.additionalData);

Krok 4 (opcjonalny): udostępnianie stanu dodatku w aktywności

Stan aktywności możesz też udostępniać między użytkownikami. Dostępne opcje możesz udostępniać stan na 2 sposoby:

  • Zajmij się tym samodzielnie, tworząc własny backend do synchronizacji.
  • używać interfejsu API Co-Doing, To wygodny i szybki sposób udostępniania dowolnych danych między użytkownikami.

Przykład: dodatek do animacji na GitHubie

Metoda „Animacja” przykładowy dodatek na GitHubie zawiera dodatek do współpracy. Krok 1 z tego przewodnika nie jest uwzględniony w próbce. Gdy osoba inicjująca wtyczkę kliknie przycisk „Rozpocznij animację” w panelu bocznym, wywoływana jest metoda startActivity() (Krok 2), która wypełnia stan początkowy wybranym przez użytkownika kolorem. Po rozpoczęciu aktywności etap główny pobiera stan początkowy, wywołując metodę getActivityStartingState() (Krok 3). Krok 4 jest pominięty, ponieważ stan (wybrany kolor) nie jest udostępniany uczestnikom podczas aktywności w tym przykładowym dodatku. Poszczególni użytkownicy mogą jednak zmieniać swój stan, wybierając kolor, który jest wysyłany z ramki panelu bocznego do ramki głównej za pomocą wiadomości między ramkami.

Ograniczenia