Interfejs Google Meet do udostępniania na żywo podczas wspólnego oglądania służy do zarządzania spotkaniami, w których 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
Na początek utwórz createCoWatchingClient
z elementu AddonSession
utworzonego w sekcji 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 tylko staje się ona dostępna. Po wywołaniu metody CoWatchingDelegate.onCoWatchingStateChanged
aplikacja powinna od razu zastosować nowy stan.
Ten 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ącym aktywności.
Zarządzaj bieżącym stanem
Gdy użytkownicy podejmują działanie w Twojej aplikacji, oczekuje się, że natychmiast wywoła podane metody interfejsu API.
Te metody należy wywoływać tylko w odpowiedzi na istotne zdarzenia. Nie musisz na przykład wywoływać ich za każdym razem, gdy aplikacja przewija odtwarzany film. W takich okolicznościach utworzony przez Ciebie powyżej element CoWatchingDelegate
umożliwia aktualizowanie pozycji odtwarzania.
Stan wspólnego oglądania możesz kontrolować, korzystając z tych metod:
CoWatchingClient.notifySwitchToMedia
: wywołaj, gdy zmieni się aktywnie odtwarzane multimedia. Na przykład użytkownik wybiera nowy film lub autoodtwarzanie rozpoczyna kolejny film.CoWatchingClient.notifyPauseState
: połączenie następuje, gdy użytkownik wstrzyma lub wznowi odtwarzanie multimediów.CoWatchingClient.notifySeekToTimestamp
: wywoływanie, gdy użytkownik wyraźnie zmieni pozycję odtwarzania.CoWatchingClient.notifyPlayoutRate
: wywoływanie, gdy użytkownik zmieni szybkość odtwarzania do nowej wartości (np.1,25x).CoWatchingClient.notifyBuffering
: wywołaj, gdy aplikacja użytkownika rozpocznie buforowanie z powodu buforowania za pomocą poprzedniego przełącznika multimediów, wyszukiwania multimediów lub przeciążenia sieci.CoWatchingClient.notifyReady
: wywołaj po zakończeniu buforowania i odtworzeniu multimediów.