AddonSession

Kotlin |Java

@PublicApi
interface AddonSession

---

Eklenti oturumu.

Tüm eklenti oturumlarında yaygın olarak kullanılan yöntemleri içerir. Birlikte izleme ve birlikte uygulama özelliklerine erişim için sırasıyla getCoWatching ve getCoDoing numaralı telefonu arayın.

Özet

İç içe yerleştirilmiş türler
@PublicApi interface AddonSession.Builder AddonSession için bir derleyici.
@PublicApi enum AddonSession.EndReason Eklenti istemcisinin eklenti oturumunu sonlandırmasının nedenleri.

Herkese açık işlevler
ListenableFuture<Void!>!	endSession() Eklenti oturumunu sonlandırır ve Meet uygulamasıyla bağlantısı kesilir.
ListenableFuture<Void!>!	endSession(endReason: AddonSession.EndReason!) Eklenti oturumunu sonlandırır, Meet uygulamasıyla bağlantısı kesilir ve bunun nedenini Meet'e bildirir.
Unit	endSuspension() Askıya alınmış durumundan çıkar.
CoDoingClient!	getCoDoing() CoDoingClient örneğini döndürür.
CoWatchingClient!	getCoWatching() CoWatchingClient örneğini döndürür.
AddonMeetingInfo!	getMeetingInfo() Bağlı toplantıyla ilgili bilgileri (ör. toplantı URL'si) döndürür.
Boolean	isSessionEnded() Oturum sona erdiyse true değerini döndürür.
Boolean	isSuspended() Oturumun askıya alınıp alınmadığını belirtir.
Unit	resetCollaborationStartingState() Eklentinin başlangıç durumunu sıfırlar.
Unit	suspend() Eklenti oturumunu askıya alır.
Unit	updateCollaborationStartingState(     startingState: CollaborationStartingState! ) Eklentinin başlangıç durumunu günceller.
Unit	updateParticipantMetadata(metadata: ByteArray!) Bu katılımcı için meta verileri günceller.

Herkese açık işlevler

endSession

fun endSession(): ListenableFuture<Void!>!

Eklenti oturumunu sonlandırır ve Meet uygulamasıyla bağlantısı kesilir. Bu işlem, Meet'i toplantıyı sonlandırmaya zorlanmaz veya kullanıcının toplantıdan ayrılmasına neden olmaz.

Oturum zaten sona erdiyse bu bir işlem değildir ve bir istisna teşkil etmez.

İlerlemeler
ListenableFuture<Void!>!	Başarı olarak değerlendiren bir ListenableFuture veya beklenmedik bir hata varsa AddonException

endSession

fun endSession(endReason: AddonSession.EndReason!): ListenableFuture<Void!>!

Eklenti oturumunu sonlandırır, Meet uygulamasıyla bağlantısı kesilir ve bunun nedenini Meet'e bildirir. Bu işlem Meet'i toplantıyı sonlandırmaya zorlamaz veya kullanıcının toplantıdan ayrılmasına neden olmaz.

Meet, eklenti istemcisiyle anlaşmaya varılan ilgili işlemleri yapabilir .

Oturum zaten sona erdiyse bu bir işlem değildir ve bir istisna teşkil etmez.

Yalnızca oturumu belirli bir nedenle sonlandırma yetkisi olan eklenti istemcileri tarafından görülebilir.

EndReason UNKNOWN ise veya geçerli değilse bu yöntem endSession ile aynı sonucu döndürür.

Parametreler
endReason: AddonSession.EndReason!	eklenti oturumunu sonlandırmasının nedeninin ortaya çıkarılmasını sağlar.

İlerlemeler
ListenableFuture<Void!>!	Başarı olarak değerlendiren bir ListenableFuture veya aşağıdaki durumlarda AddonException

endSuspension

fun endSuspension(): Unit

Askıya alınmış durumundan çıkar. Eklenti uygulaması tekrar güncelleme gönderip alabilir.

Bu, askıya alınmış bir durumda değilse, herhangi bir işlem yapılmaz.

Fırlatma
java.lang.IllegalStateException	devam edebilir. Bu durum, endSession adresine açıkça yapılmış bir çağrı veya onSessionEnded aracılığıyla gösterilecek harici bir nedenden kaynaklanıyor olabilir.

getCoDoing

fun getCoDoing(): CoDoingClient!

CoDoingClient örneğini döndürür.

Fırlatma
java.lang.IllegalStateException	oturum, withCoDoing çağrılmadan oluşturulduysa veya oturum sona erdiyse

getCoWatching

fun getCoWatching(): CoWatchingClient!

CoWatchingClient örneğini döndürür.

Fırlatma
java.lang.IllegalStateException	oturum, withCoWatching çağrılmadan oluşturulduysa veya oturum sona erdiyse

getMeetingInfo

fun getMeetingInfo(): AddonMeetingInfo!

Bağlı toplantıyla ilgili bilgileri (ör. toplantı URL'si) döndürür.

Fırlatma
java.lang.IllegalStateException	devam edebilir. Bu durum, endSession adresine açıkça yapılmış bir çağrı veya onSessionEnded aracılığıyla gösterilecek harici bir nedenden kaynaklanıyor olabilir.

isSessionEnded

fun isSessionEnded(): Boolean

Oturum sona erdiyse true değerini döndürür. Bu durum, endSession numaralı telefona yapılan açık bir çağrıdan veya onSessionEnded aracılığıyla gösterilecek harici bir nedenden kaynaklanıyor olabilir.

Fırlatma
java.lang.IllegalStateException	devam edebilir. Bu durum, endSession adresine açıkça yapılmış bir çağrı veya onSessionEnded aracılığıyla gösterilecek harici bir nedenden kaynaklanıyor olabilir.

isSuspended

fun isSuspended(): Boolean

Oturumun askıya alınıp alınmadığını belirtir. suspend ve endSuspension hükümlerini inceleyin.

Fırlatma
java.lang.IllegalStateException	devam edebilir. Bu durum, endSession adresine açıkça yapılmış bir çağrı veya onSessionEnded aracılığıyla gösterilecek harici bir nedenden kaynaklanıyor olabilir.

resetCollaborationStartingState

fun resetCollaborationStartingState(): Unit

Eklentinin başlangıç durumunu sıfırlar. Bu işlem, diğer katılımcıların önceden aldığı başlangıç durumunu siler. Başlangıç durumu yalnızca başlatan kullanıcı tarafından sıfırlanabilir.

suspend

fun suspend(): Unit

Eklenti oturumunu askıya alır. Bu durumda Meet uygulaması bağlantısı kesilmez. Bu durum, SDK'nın CoDoingHandler ve CoWatchingHandler cihazlarınıza güncelleme göndermekten kaçınmasına ve SDK'nın, aramaları bildirmek için çağrıları yoksaymasına ve genel durumu güncellemek için çağrıları yoksaymasına neden olur.

Oturum zaten askıya alınmışsa işlem yapılamaz.

Örneğin, bir kullanıcı (ancak tüm kullanıcılar değil) bir reklam izlemek için oynatma kesintiye uğradığında, kullanıcı uygulamayı arka plana aldığında vb. suspend aramasını seçebilirsiniz.

Fırlatma
java.lang.IllegalStateException	devam edebilir. Bu durum, endSession adresine açıkça yapılmış bir çağrı veya onSessionEnded aracılığıyla gösterilecek harici bir nedenden kaynaklanıyor olabilir.

updateCollaborationStartingState

fun updateCollaborationStartingState(
    startingState: CollaborationStartingState!
): Unit

Eklentinin başlangıç durumunu günceller. Bu bildirim, ortak çalışma davetini kabul eden diğer katılımcılar tarafından alınır. Başlangıç durumu yalnızca başlatan kullanıcı tarafından güncellenebilir.

Parametreler
startingState: CollaborationStartingState!	eklentinin başlangıç durumu

updateParticipantMetadata

fun updateParticipantMetadata(metadata: ByteArray!): Unit

Bu katılımcı için meta verileri günceller.

Diğer katılımcılardan meta veri almak için bir işleyicinin, AddonSession oluşturulurken katılımcı meta verisiyle çağırarak kaydedilmiş olması gerekir.

Kodlanmış meta veriler katılımcı başına MAX_INDIVIDUAL_PARTICIPANT_METADATA_SIZE_BYTES bayt ile sınırlıdır.

Parametreler
metadata: ByteArray!	yerel katılımcıyla ilgili meta verileri açıklayan kodlanmış bir meta veri blobu

Fırlatma
java.lang.IllegalArgumentException	Sağlanan meta veriler MAX_INDIVIDUAL_PARTICIPANT_METADATA_SIZE_BYTES baytı aşarsa
java.lang.IllegalStateException	devam edebilir. Bu durum, endSession adresine açıkça yapılmış bir çağrı veya onSessionEnded aracılığıyla gösterilecek harici bir nedenden kaynaklanıyor olabilir.