CoWatchingClient

Kotlin |자바

@PublicApi
public interface CoWatchingClient

---

---

사전 체험 프로그램: 이 기능은 사전 체험판 프로그램을 통해 일부 미리보기로만 제공됩니다.

공동 시청 세션을 나타냅니다.

Meet에 최근 사용자 작업 (예: 재생/일시중지/탐색) 및 미디어 버퍼링으로 인한 지연과 같은 환경 요소를 알립니다.

요약

상수
default static final double	MAX_PLAYOUT_RATE = 2.0 허용되는 최대 재생 속도입니다.
default static final double	MAX_SEEKS_PER_SECOND = 0.9 초당 허용되는 최대 탐색 수입니다.

공개 메서드
abstract void	notifyBuffering(Duration mediaPlayoutPosition) 이전 미디어 전환, 미디어 탐색 또는 일반적인 네트워크 정체로 인해 버퍼링으로 인해 미디어를 재생할 준비가 되지 않았음을 Meet에 알립니다.
abstract void	notifyEnded(Duration mediaPlayoutPosition) 미디어 플레이어가 현재 미디어 끝에 도달했음을 Meet에 알립니다.
abstract void	notifyPauseState(boolean paused, Duration mediaPlayoutPosition) 사용자가 미디어 재생을 일시중지하거나 일시중지를 해제했음을 Meet에 알리면 Meet에서 다른 사용자에게 해당 작업을 미러링할 수 있습니다.
abstract void	notifyPlayoutRate(double rate, Duration mediaPlayoutPosition) 사용자가 미디어 재생 속도를 업데이트했음을 Meet에 알립니다 (예:
abstract void	notifyQueueUpdate(CoWatchingQueue queue) 대기열이 변경되었음을 Meet에 알립니다. 그러면 Meet에서 대기열을 다른 사용자에게 미러링할 수 있습니다.
abstract void	notifyReady(Duration mediaPlayoutPosition) 제공된 타임스탬프부터 버퍼링이 완료되고 미디어를 재생할 준비가 되었음을 Meet에 알립니다.
abstract void	notifySeekToTimestamp(Duration mediaPlayoutPosition) 사용자가 미디어의 재생 지점을 찾았다고 Meet에 알리면 Meet에서 다른 사용자에게 해당 작업을 미러링할 수 있습니다.
abstract void	notifySwitchedToMedia(     String mediaTitle,     String mediaId,     Duration mediaPlayoutPosition ) Meet에서 다른 사용자에게 미디어를 전달할 수 있도록 사용자가 미디어를 전환했음을 Meet에 알립니다.
abstract void	notifySwitchedToMedia(     String mediaTitle,     String mediaId,     Duration mediaPlayoutPosition,     CoWatchingQueue queue ) Meet에서 다른 사용자에게 전달할 수 있도록 시뮬레이션 대기열 업데이트를 통해 사용자가 미디어를 전환했음을 Meet에 알립니다.

상수

MAX_PLAYOUT_RATE

default static final double MAX_PLAYOUT_RATE = 2.0

허용되는 최대 재생 속도입니다.

MAX_SEEKS_PER_SECOND

default static final double MAX_SEEKS_PER_SECOND = 0.9

초당 허용되는 최대 탐색 수입니다.

공개 메서드

notifyBuffering

abstract void notifyBuffering(Duration mediaPlayoutPosition)

이전 미디어 전환, 미디어 탐색 또는 일반적인 네트워크 정체로 인해 버퍼링으로 인해 미디어를 재생할 준비가 되지 않았음을 Meet에 알립니다.

매개변수
Duration mediaPlayoutPosition	미디어가 일시중지되어 버퍼링이 완료되기를 기다리는 위치

생성 값
java.lang.NullPointerException	mediaPlayoutPosition가 null인 경우
com.google.android.meet.addons.AddonException	예기치 않은 오류가 발생한 경우
java.lang.IllegalStateException	공동 시청 세션이 종료된 후 호출되는 경우

notifyEnded

abstract void notifyEnded(Duration mediaPlayoutPosition)

미디어 플레이어가 현재 미디어 끝에 도달했음을 Meet에 알립니다.

참고: 미디어가 종료되는 즉시 자동 재생 메커니즘을 통해 NotificationSwitchedToMedia가 호출되면 이 메서드를 호출할 필요가 없습니다 (유해하지는 않음).

매개변수
Duration mediaPlayoutPosition	플레이어의 마지막 위치

생성 값
java.lang.NullPointerException	mediaPlayoutPosition가 null인 경우
com.google.android.meet.addons.AddonException	예기치 않은 오류가 발생한 경우
java.lang.IllegalStateException	공동 시청 세션이 종료된 후 호출되는 경우

notifyPauseState

abstract void notifyPauseState(boolean paused, Duration mediaPlayoutPosition)

사용자가 미디어 재생을 일시중지하거나 일시중지를 해제했음을 Meet에 알리면 Meet에서 다른 사용자에게 해당 작업을 미러링할 수 있습니다.

매개변수
boolean paused	일시중지된 경우 true, 재생이 다시 시작된 경우 false
Duration mediaPlayoutPosition	미디어가 일시중지되거나 일시중지가 해제된 위치

생성 값
java.lang.NullPointerException	mediaPlayoutPosition가 null인 경우
com.google.android.meet.addons.AddonException	예기치 않은 오류가 발생한 경우
java.lang.IllegalStateException	공동 시청 세션이 종료된 후 호출되는 경우

notifyPlayoutRate

abstract void notifyPlayoutRate(double rate, Duration mediaPlayoutPosition)

사용자가 미디어 재생 속도를 업데이트했음을 Meet에 알립니다 (예: 1.25x)를 새 값으로 변경합니다.

매개변수
double rate	현재 미디어가 재생되는 속도
Duration mediaPlayoutPosition	플레이어의 현재 위치

생성 값
java.lang.IllegalStateException	rate가 양수가 아닌 경우
java.lang.IllegalStateException	rate이 MAX_PLAYOUT_RATE보다 큰 경우
com.google.android.meet.addons.AddonException	예기치 않은 오류가 발생한 경우
java.lang.IllegalStateException	공동 시청 세션이 종료된 후 호출되는 경우

notifyQueueUpdate

abstract void notifyQueueUpdate(CoWatchingQueue queue)

대기열이 변경되었음을 Meet에 알립니다. 그러면 Meet에서 대기열을 다른 사용자에게 미러링할 수 있습니다.

매개변수
CoWatchingQueue queue	부가기능 앱의 대기열에 관한 정보

생성 값
java.lang.NullPointerException	queue가 null인 경우
com.google.android.meet.addons.AddonException	예기치 않은 오류가 발생한 경우
java.lang.IllegalStateException	공동 시청 세션이 종료된 후 호출되는 경우

notifyReady

abstract void notifyReady(Duration mediaPlayoutPosition)

제공된 타임스탬프부터 버퍼링이 완료되고 미디어를 재생할 준비가 되었음을 Meet에 알립니다.

매개변수
Duration mediaPlayoutPosition	미디어가 버퍼링되어 재생할 준비가 된 위치

생성 값
java.lang.NullPointerException	mediaPlayoutPosition가 null인 경우
com.google.android.meet.addons.AddonException	예기치 않은 오류가 발생한 경우
java.lang.IllegalStateException	공동 시청 세션이 종료된 후 호출되는 경우

notifySeekToTimestamp

abstract void notifySeekToTimestamp(Duration mediaPlayoutPosition)

사용자가 미디어의 재생 지점을 찾았다고 Meet에 알리면 Meet에서 다른 사용자에게 해당 작업을 미러링할 수 있습니다.

매개변수
Duration mediaPlayoutPosition	사용자가 검색한 타임스탬프

생성 값
java.lang.NullPointerException	mediaPlayoutPosition가 null인 경우
com.google.android.meet.addons.AddonException	예기치 않은 오류가 발생한 경우
java.lang.IllegalStateException	공동 시청 세션이 종료된 후 호출되는 경우
java.lang.IllegalStateException	초당 탐색 수가 MAX_SEEKS_PER_SECOND보다 큰 경우

notifySwitchedToMedia

abstract void notifySwitchedToMedia(
    String mediaTitle,
    String mediaId,
    Duration mediaPlayoutPosition
)

Meet에서 다른 사용자에게 미디어를 전달할 수 있도록 사용자가 미디어를 전환했음을 Meet에 알립니다.

매개변수
String mediaTitle	전환된 미디어의 제목입니다. 다른 사용자가 공동 시청 세션 연결을 고려하면 이 제목이 Meet UI에 반영됩니다.
String mediaId	전환된 미디어의 문자열 URI
Duration mediaPlayoutPosition	미디어 재생이 시작된 위치

생성 값
java.lang.NullPointerException	mediaId 또는 mediaPlayoutPosition가 null인 경우
com.google.android.meet.addons.AddonException	예기치 않은 오류가 발생한 경우
java.lang.IllegalStateException	공동 시청 세션이 종료된 후 호출되는 경우

notifySwitchedToMedia

abstract void notifySwitchedToMedia(
    String mediaTitle,
    String mediaId,
    Duration mediaPlayoutPosition,
    CoWatchingQueue queue
)

Meet에서 다른 사용자에게 전달할 수 있도록 시뮬레이션 대기열 업데이트를 통해 사용자가 미디어를 전환했음을 Meet에 알립니다.

매개변수
String mediaTitle	전환된 미디어의 제목입니다. 다른 사용자가 공동 시청 세션 연결을 고려하면 이 제목이 Meet UI에 반영됩니다.
String mediaId	전환된 미디어의 문자열 URI
Duration mediaPlayoutPosition	미디어 재생이 시작된 위치
CoWatchingQueue queue	부가기능 앱의 대기열에 관한 정보

생성 값
java.lang.NullPointerException	mediaId, mediaPlayoutPosition 또는 queue가 null인 경우
com.google.android.meet.addons.AddonException	예기치 않은 오류가 발생한 경우
java.lang.IllegalStateException	공동 시청 세션이 종료된 후 호출되는 경우