Condividi tramite


com.microsoft.connecteddevices

Classi

AsyncOperation<T>

Operazione con un risultato futuro di tipo T o di una possibile eccezione. Questa classe è una versione leggermente semplificata della classe api Android livello 24 CompletableFuture

Implementa l'interfaccia standard Future e fornisce anche funzionalità di continuazione di base. Per informazioni dettagliate su come usare questa classe, vedere CompletableFuture.

Le differenze importanti tra CompletableFuture e AsyncOperation sono le seguenti: 1. L'executor asincrono predefinito di AsyncOperation è Executors.newCachedThreadPool() mentre CompletableFuture usa ForkJoinPool.commonPool(). 2. AsyncOperation non dispone di metodi obtrudeException e obtrudeValue.

AsyncOperationWithProgress<T,P>

Versione di AsyncOperation in grado di fornire lo stato di avanzamento tramite l'evento Progress.

ConnectedDevicesAccessTokenInvalidatedEventArgs

Restituito da ConnectedDevicesAccount per informare che il token associato a ConnectedDevicesAccount errore di token segnalato per gli ambiti contenuti. Il provider di token deve aggiornare la cache dei token o potenzialmente visualizzare l'interfaccia utente per chiedere all'utente di accedere per correggere la configurazione dell'account.

ConnectedDevicesAccessTokenRequest

Richiedere un token di accesso per il ConnectedDevicesAccount contenuto che soddisfa gli ambiti contenuti. Questa richiesta deve essere completata chiamando completeWithAccessToken(@NonNull final String token) o completeWithErrorMessage(@NonNull final String error).

ConnectedDevicesAccessTokenRequestedEventArgs

Restituito da ConnectedDevicesAccount attivato quando è necessario richiedere un token. Contiene il ConnectedDevicesAccessTokenRequest.

ConnectedDevicesAccount

Questa classe rappresenta un singolo account utente noto da un'app.

ConnectedDevicesAccountManager

Fornisce un singolo punto di ingresso per tutte le funzionalità correlate all'account nell'SDK.

ConnectedDevicesAddAccountResult
ConnectedDevicesDiagnostics

Gestisce le informazioni di diagnostica dalla piattaforma Dispositivi connessi. Non destinato all'uso generico.

ConnectedDevicesNotification

Oggetto che rappresenta una notifica in ingresso da elaborare dalla piattaforma dispositivi connessi

ConnectedDevicesNotificationRegistration

Questa classe rappresenta la registrazione dell'app con un servizio di notifica push (necessario per alcuni scenari di dispositivi connessi). Trasmette queste informazioni alla piattaforma dispositivi connessi.

ConnectedDevicesNotificationRegistrationManager

Gestisce la registrazione delle notifiche push con ConnectedDevicesPlatform per ogni account.

ConnectedDevicesNotificationRegistrationResult
ConnectedDevicesNotificationRegistrationStateChangedEventArgs

Classe Args di evento per l'evento RemoteSystemAppRegistration State Changed. Viene usato come parte del ConnectedDevicesPlatform per assicurarsi che l'applicazione venga informata sui nuovi messaggi ConnectedDevices tramite il meccanismo di notifica corretto.

ConnectedDevicesPlatform

Classe per rappresentare la piattaforma dispositivi connessi e gestire la connessione dell'app.

ConnectedDevicesPlatformSettings

Consente agli sviluppatori di applicazioni di fornire le impostazioni iniziali alla piattaforma ConnectedDevices.

ConnectedDevicesProcessNotificationOperation

Il risultato di inviare una notifica alla piattaforma Roma per l'elaborazione.

ConnectedDevicesRemoveAccountResult
SdkException

Eccezione usata per comunicare un errore da Connected Devices Platform SDK. Si tratta di un'eccezione deselezionata che verrà generata per errori imprevisti correlati alla piattaforma.

AsyncOperation.CompletionException

Eccezione deselezionata che contiene l'eccezione che ha causato il completamento dell'operazione in modo eccezionale.

Usato come ExecutionException ad eccezione del fatto che è deselezionato in modo che possa propagarsi alle operazioni dipendenti senza dover conoscere il set completo di eccezioni/richiedere a tutte le eccezioni di osservare le continuazioni per dichiarare che possono generare l'eccezione ExecutionException.

Interfacce

Event<T,R>

Questa interfaccia fornisce un modello di eventi semplice. Gli eventi producono elementi utilizzati da EventListeners. Il flusso degli elementi dell'evento è controllato dall'oggetto EventSubscription.

EventListener<T,R>

Questa interfaccia fornisce un semplice metodo di gestione degli eventi. Consente la registrazione dei listener ai metodi tramite l'uso di espressioni lambda (disponibile in Java 8). Poiché le espressioni lambda e le classi anonime consentono l'acquisizione implicita di variabili nell'ambito di inclusione, è importante ricordare di usare WeakReferences o di chiamare sempre EventSubscription.cancel per garantire una corretta pulizia delle risorse.

EventSubscription

Questa interfaccia fornisce una sottoscrizione di eventi semplice

AsyncOperation.ResultBiConsumer<T,U>

Rappresenta un'azione da richiamare dopo l'esecuzione di un'operazione asincrona. In particolare, questa interfaccia funzionale viene usata quando vengono usati due argomenti di chiamata come con AsyncOperation.whenComplete.

Si tratta di un'interfaccia funzionale equivalente all'interfaccia BiConsumer di Android

AsyncOperation.ResultBiFunction<T,U,R>

Rappresenta una funzione da richiamare dopo l'operazione di AsyncOperation. In particolare, questa interfaccia funzionale viene usata quando sono necessari solo due argomenti e viene generato un risultato, ad esempio con AsyncOperation.handleAsync

Si tratta di un'interfaccia funzionale equivalente all'interfaccia BiFunction di Android

AsyncOperation.ResultConsumer<T>

Rappresenta un'azione da richiamare dopo l'esecuzione di un'operazione asincrona. In particolare, questa interfaccia funzionale viene usata quando è necessario un solo argomento, ad esempio con AsyncOperation.thenAccept.

Si tratta di un'interfaccia funzionale equivalente all'interfaccia consumer di Android

AsyncOperation.ResultFunction<T,R>

Rappresenta una funzione da richiamare dopo l'operazione di AsyncOperation. In particolare, questa interfaccia funzionale viene usata quando è necessario solo un argomento singe e viene generato un risultato, ad esempio con AsyncOperation.thenApply

Si tratta di un'interfaccia funzionale equivalente all'interfaccia function di Android

AsyncOperation.Supplier<T>

Rappresenta una funzione che fornisce un valore T (non necessariamente nuovo/distinto) quando richiesto.

Si tratta di un'interfaccia funzionale equivalente all'interfaccia Supplier di Android

Enumerazioni

ConnectedDevicesAccountAddedStatus

Contiene i valori che descrivono lo stato dell'operazione add account

ConnectedDevicesAccountType

Contiene valori che descrivono il tipo di account utente fornito da Microsoft.

ConnectedDevicesNotificationRegistrationState

Valori usati per comunicare lo stato della registrazione cloud.

ConnectedDevicesNotificationRegistrationStatus

Contiene i valori che descrivono lo stato dell'operazione di registrazione notifcation. Gli stati di errore indicano condizioni temporanee in cui lo sviluppatore dell'app potrebbe voler ripetere la registrazione.

ConnectedDevicesNotificationType

Contiene valori che descrivono il tipo (servizio) di una notifica.