CoWatchingClient

Kotlin |자바

@PublicApi
interface CoWatchingClient

---

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

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

요약

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

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

상수

MAX_PLAYOUT_RATE

const val MAX_PLAYOUT_RATE = 2.0: Double

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

MAX_SEEKS_PER_SECOND

const val MAX_SEEKS_PER_SECOND = 0.9: Double

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

공개 함수

notifyBuffering

fun notifyBuffering(mediaPlayoutPosition: Duration!): Unit

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

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

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

notifyEnded

fun notifyEnded(mediaPlayoutPosition: Duration!): Unit

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

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

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

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

notifyPauseState

fun notifyPauseState(paused: Boolean, mediaPlayoutPosition: Duration!): Unit

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

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

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

notifyPlayoutRate

fun notifyPlayoutRate(rate: Double, mediaPlayoutPosition: Duration!): Unit

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

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

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

notifyQueueUpdate

fun notifyQueueUpdate(queue: CoWatchingQueue!): Unit

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

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

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

notifyReady

fun notifyReady(mediaPlayoutPosition: Duration!): Unit

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

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

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

notifySeekToTimestamp

fun notifySeekToTimestamp(mediaPlayoutPosition: Duration!): Unit

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

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

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

notifySwitchedToMedia

fun notifySwitchedToMedia(
    mediaTitle: String!,
    mediaId: String!,
    mediaPlayoutPosition: Duration!
): Unit

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

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

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

notifySwitchedToMedia

fun notifySwitchedToMedia(
    mediaTitle: String!,
    mediaId: String!,
    mediaPlayoutPosition: Duration!,
    queue: CoWatchingQueue!
): Unit

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

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

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