AddonSession.Builder

Kotlin |Java

@PublicApi
public interface AddonSession.Builder

---

---

Programma di accesso in anteprima: questa funzionalità è disponibile solo in anteprima limitata, tramite un programma di accesso in anteprima.

Un costruttore per AddonSession. Leggi i newSessionBuilder.

Riepilogo

Metodi pubblici
abstract ListenableFuture<AddonSession>	begin(Context appContext) Avvia una sessione di componenti aggiuntivi.
abstract AddonSession.Builder	@CanIgnoreReturnValue withCoDoing(CoDoingHandler coDoingHandler) Aggiunge le azioni condivise alla sessione del componente aggiuntivo con lo stato iniziale.
abstract AddonSession.Builder	@CanIgnoreReturnValue withCoDoing(     CoDoingHandler coDoingHandler,     Optional<CoDoingState> initiatorInitialState ) Aggiunge l'attività condivisa alla sessione del componente aggiuntivo.
abstract AddonSession.Builder	@CanIgnoreReturnValue withCoWatching(CoWatchingHandler coWatchingHandler) Aggiunge la visione condivisa alla sessione del componente aggiuntivo.
abstract AddonSession.Builder	@CanIgnoreReturnValue withCoWatching(     CoWatchingHandler coWatchingHandler,     Optional<CoWatchingState> initiatorInitialState ) Aggiunge la visione condivisa alla sessione del componente aggiuntivo con lo stato iniziale.
abstract AddonSession.Builder	@CanIgnoreReturnValue withCollaborationStartingState(     CollaborationStartingState collaborationStartingState ) Imposta il CollaborationStartingState per la sessione.
abstract AddonSession.Builder	@CanIgnoreReturnValue withParticipantMetadata(ParticipantMetadataHandler handler) Registra un listener per gli aggiornamenti dei metadati per altri partecipanti.
abstract AddonSession.Builder	@CanIgnoreReturnValue withParticipantMetadata(     ParticipantMetadataHandler handler,     byte[] metadata ) Imposta i metadati per questo partecipante e registra un ascoltatore per gli aggiornamenti per gli altri partecipanti.

Metodi pubblici

iniziale

abstract ListenableFuture<AddonSession> begin(Context appContext)

Avvia una sessione di componenti aggiuntivi. Questa chiamata deve essere chiamata solo dopo che l'utente ha confermato di voler partecipare a una sessione aggiuntiva.

Si connette a una riunione creando una riunione o collegandosi a una riunione in corso. Note:

• Se viene creata una riunione, inizialmente l'utente corrente sarà l'unico partecipante.
• È possibile accedere ai dettagli della riunione tramite getMeetingInfo nella sessione restituita.
• L'URL restituito è destinato a essere mostrato all'utente e condiviso manualmente con il gruppo di sessioni del componente aggiuntivo previsto.

È possibile accedere alle istanze di visualizzazione condivisa e condivisa tramite getCoWatching e getCoDoing.

Non è consigliabile chiamare cancel in futuro, ma consentirne l'esecuzione fino al completamento.

Parametri
Context appContext	il valore getApplicationContext dell'applicazione che utilizza l'SDK

Ritorni
ListenableFuture<AddonSession>	un ListenableFuture che restituisce un'istanza AddonSession del tipo appropriato se una sessione di un componente aggiuntivo è stata avviata correttamente. In caso contrario, restituisce un IllegalStateException se un altro AddonSession è ancora in esecuzione (ad es. endSession non è stato chiamato) o un AddonException se si è verificato un errore imprevisto.

withCoDoing

@CanIgnoreReturnValue
abstract AddonSession.Builder withCoDoing(CoDoingHandler coDoingHandler)

Aggiunge le azioni condivise alla sessione del componente aggiuntivo con lo stato iniziale.

Parametri
CoDoingHandler coDoingHandler	di invito all'azione

Ritorni
AddonSession.Builder	un'altra istanza del builder per il concatenamento

Lanci
java.lang.NullPointerException	se coDoingHandler è null

withCoDoing

@CanIgnoreReturnValue
abstract AddonSession.Builder withCoDoing(
    CoDoingHandler coDoingHandler,
    Optional<CoDoingState> initiatorInitialState
)

Aggiunge l'attività condivisa alla sessione del componente aggiuntivo.

Parametri
CoDoingHandler coDoingHandler	di invito all'azione
Optional<CoDoingState> initiatorInitialState	lo stato iniziale di chi l'ha iniziato. Questo valore verrà ignorato se l'utente partecipa a una sessione esistente

Ritorni
AddonSession.Builder	un'altra istanza del builder per il concatenamento

Lanci
java.lang.NullPointerException	se coDoingHandler o initiatorInitialState è null

withCoWatching

@CanIgnoreReturnValue
abstract AddonSession.Builder withCoWatching(CoWatchingHandler coWatchingHandler)

Aggiunge la visione condivisa alla sessione del componente aggiuntivo.

Parametri
CoWatchingHandler coWatchingHandler	richiamate per la visione condivisa

Ritorni
AddonSession.Builder	un'altra istanza del builder per il concatenamento

Lanci
java.lang.NullPointerException	se coWatchingHandler è null

withCoWatching

@CanIgnoreReturnValue
abstract AddonSession.Builder withCoWatching(
    CoWatchingHandler coWatchingHandler,
    Optional<CoWatchingState> initiatorInitialState
)

Aggiunge la visione condivisa alla sessione del componente aggiuntivo con lo stato iniziale.

Parametri
CoWatchingHandler coWatchingHandler	richiamate per la visione condivisa
Optional<CoWatchingState> initiatorInitialState	lo stato iniziale di chi l'ha iniziato. Questo valore verrà ignorato se l'utente partecipa a una sessione esistente

Ritorni
AddonSession.Builder	un'altra istanza del builder per il concatenamento

Lanci
java.lang.NullPointerException	se coWatchingHandler o initiatorInitialState è null

withCollaborationStartingState

@CanIgnoreReturnValue
abstract AddonSession.Builder withCollaborationStartingState(
    CollaborationStartingState collaborationStartingState
)

Imposta il CollaborationStartingState per la sessione.

Questa opzione può essere modificata in un secondo momento chiamando il numero updateCollaborationStartingState o resetCollaborationStartingState.

Parametri
CollaborationStartingState collaborationStartingState	CollaborationStartingState di dati

Lanci
java.lang.NullPointerException	se collaborationStartingState è null

withParticipantMetadata

@CanIgnoreReturnValue
abstract AddonSession.Builder withParticipantMetadata(ParticipantMetadataHandler handler)

Registra un listener per gli aggiornamenti dei metadati per altri partecipanti.

I metadati del partecipante locale verranno inizialmente impostati su un valore vuoto, ma possono essere impostati in un secondo momento chiamando updateParticipantMetadata. Per impostare il valore iniziale, chiama withParticipantMetadata.

Parametri
ParticipantMetadataHandler handler	Un ParticipantMetadataHandler per ricevere l'ultimo insieme di metadati dei partecipanti a ogni aggiornamento

Lanci
java.lang.NullPointerException	se handler è null

withParticipantMetadata

@CanIgnoreReturnValue
abstract AddonSession.Builder withParticipantMetadata(
    ParticipantMetadataHandler handler,
    byte[] metadata
)

Imposta i metadati per questo partecipante e registra un ascoltatore per gli aggiornamenti per gli altri partecipanti.

Questi metadati possono essere modificati in un secondo momento chiamando updateParticipantMetadata.

I metadati codificati sono limitati a MAX_INDIVIDUAL_PARTICIPANT_METADATA_SIZE_BYTES byte per partecipante.

Parametri
ParticipantMetadataHandler handler	Un ParticipantMetadataHandler per ricevere l'ultimo insieme di metadati dei partecipanti a ogni aggiornamento
byte[] metadata	un blob codificato di metadati che descrive i metadati pertinenti per il partecipante locale

Lanci
java.lang.IllegalArgumentException	se i metadati forniti superano MAX_INDIVIDUAL_PARTICIPANT_METADATA_SIZE_BYTES byte
java.lang.NullPointerException	se handler è null