Wdrażanie interfejsu Co-Watching API

Interfejs Co-Watching API w Google Meet służy do zarządzania sposobem, w jaki wielu uczestników ogląda lub słucha treści w Twojej aplikacji.

Z tego przewodnika dowiesz się, jak wdrożyć interfejs Co-Watching API.

Utwórz CoWatchingClient

Zacznij od utworzenia createCoWatchingClient na podstawie AddonSession utworzonego na stronie Pierwsze kroki.

Aby utworzyć CoWatchingCient, wywołaj metodę AddonSession.createCoWatchingClient i podaj CoWatchingDelegate.

CoWatchingDelegate to sposób, w jaki interfejs Co-Watching API aktualizuje Twoją aplikację, gdy uzyska nowy stan. Gdy wywołana metoda CoWatchingDelegate.onCoWatchingStateChanged powinna zostać wywołana, aplikacja od razu zastosuje nowy stan.

Poniższy przykładowy kod pokazuje, jak korzystać z interfejsu Co-Watching API:

TypeScript

 const coWatchingClient = await addonSession.createCoWatchingClient({
    activityTitle: "ACTIVITY_TITLE",
    onCoWatchingStateQuery() {
      // This function should return the current state of your CoWatching activity
      return getMyApplicationCoWatchingState();
    },
    onCoWatchingStateChanged(coWatchingState: CoWatchingState) {
      // This function should apply newState to your ongoing CoWatching activity
    },
  });

Zastąp ACTIVITY_TITLE tytułem multimediów dotyczących aktywności.

Zarządzaj bieżącym stanem

Gdy użytkownicy wykonują działania w Twojej aplikacji, powinna ona natychmiast wywoływać podane metody interfejsu API.

Te metody należy wywoływać tylko w odpowiedzi na ważne zdarzenia. Na przykład nie musisz dzwonić do nich za każdym razem, gdy aplikacja przesuwa odtwarzany film. W tej sytuacji obiekt CoWatchingDelegate utworzony powyżej obsługuje pobieranie zaktualizowanych pozycji odtwarzania.

Stan wspólnego oglądania możesz kontrolować za pomocą tych metod: