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:
CoWatchingClient.notifySwitchToMedia
: wywołaj, gdy zmieni się aktywne odtwarzanie multimediów. Na przykład użytkownik wybiera nowy film lub autoodtwarzanie rozpoczyna następny.CoWatchingClient.notifyPauseState
: wywołaj, gdy użytkownik wstrzyma lub wznowi odtwarzanie multimediów.CoWatchingClient.notifySeekToTimestamp
: wywołaj, gdy użytkownik wyraźnie zmieni pozycję odtwarzania.CoWatchingClient.notifyPlayoutRate
: wywołanie, gdy użytkownik zaktualizuje szybkość odtwarzania do nowej wartości (np.1,25x).CoWatchingClient.notifyBuffering
: wywołaj, gdy aplikacja użytkownika zacznie się buforować w wyniku buforowania z powodu buforowania z powodu poprzedniego przełącznika multimediów, wyszukiwania multimediów lub przeciążenia sieci.CoWatchingClient.notifyReady
: wywołaj po zakończeniu buforowania, gdy multimedia będą gotowe do odtwarzania.