com.microsoft.connecteddevices

Classes

AsyncOperation<T>

Opération qui a un résultat futur de type T ou une exception possible. Cette classe est une version légèrement simplifiée de la classe Android API niveau 24 CompletableFuture

Implémente l’interface Future standard et fournit également des fonctionnalités de continuation de base. Pour plus d’informations sur l’utilisation de cette classe, consultez CompletableFuture .

Les différences importantes entre CompletableFuture et AsyncOperation sont les suivantes : 1. L’exécuteur asynchrone par défaut d’AsyncOperation est Executors.newCachedThreadPool(), tandis que CompletableFuture utilise ForkJoinPool.commonPool(). 2. AsyncOperation ne dispose pas de méthodes obtrudeException et obtrudeValue.

AsyncOperationWithProgress<T,P>

Version d’AsyncOperation qui peut fournir une progression via l’événement Progress.

ConnectedDevicesAccessTokenInvalidatedEventArgs

Retourné par ConnectedDevicesAccount pour informer que le jeton associé ConnectedDevicesAccount à l’erreur de jeton signalée pour les étendues contenues. Le fournisseur de jetons doit actualiser son cache de jetons ou éventuellement afficher une interface utilisateur pour demander à l’utilisateur de se connecter afin de corriger la configuration de son compte.

ConnectedDevicesAccessTokenRequest

Demande d’un jeton d’accès pour le contenu ConnectedDevicesAccount qui satisfait aux étendues contenues. Cette demande doit être effectuée en appelant completeWithAccessToken(@NonNull final String token) ou completeWithErrorMessage(@NonNull final String error).

ConnectedDevicesAccessTokenRequestedEventArgs

Retourné par ConnectedDevicesAccount déclenché lorsqu’il est nécessaire de demander un jeton. Contient .ConnectedDevicesAccessTokenRequest

ConnectedDevicesAccount

Cette classe représente un compte d’utilisateur unique connu par une application.

ConnectedDevicesAccountManager

Fournit un point d’entrée unique pour toutes les fonctionnalités liées au compte dans le Kit de développement logiciel (SDK).

ConnectedDevicesAddAccountResult
ConnectedDevicesDiagnostics

Gère les informations de diagnostic à partir de la plateforme Appareils connectés. Non destiné à une utilisation générale.

ConnectedDevicesNotification

Objet qui représente une notification entrante à traiter par la plateforme d’appareils connectés

ConnectedDevicesNotificationRegistration

Cette classe représente l’inscription de l’application avec un service de notification Push (nécessaire pour certains scénarios d’appareils connectés). Il transmet ces informations à la plateforme d’appareils connectés.

ConnectedDevicesNotificationRegistrationManager

Gère l’inscription des notifications Push avec ConnectedDevicesPlatform pour chaque compte.

ConnectedDevicesNotificationRegistrationResult
ConnectedDevicesNotificationRegistrationStateChangedEventArgs

Classe Event Args pour l’événement RemoteSystemAppRegistration State Changed. Cela est utilisé dans le ConnectedDevicesPlatform cadre du pour s’assurer que l’application est informée des nouveaux messages ConnectedDevices via le mécanisme de notification approprié.

ConnectedDevicesPlatform

Classe pour représenter la plateforme d’appareils connectés et gérer la connexion de l’application à celle-ci.

ConnectedDevicesPlatformSettings

Permet aux développeurs d’applications de fournir des paramètres initiaux à la plateforme ConnectedDevices.

ConnectedDevicesProcessNotificationOperation

Résultat d’une notification à la plateforme de Rome pour traitement.

ConnectedDevicesRemoveAccountResult
SdkException

Exception utilisée pour communiquer un échec à partir du Kit de développement logiciel (SDK) de plateforme d’appareils connectés. Il s’agit d’une exception non cochée qui sera levée pour les erreurs inattendues liées à la plateforme.

AsyncOperation.CompletionException

Exception décochée qui contient l’exception qui a provoqué la fin exceptionnelle de l’opération.

Utilisé comme sauf ExecutionException qu’il est décoché afin qu’il puisse se propager à des opérations dépendantes sans avoir besoin de connaître l’ensemble complet des exceptions / exigeant que toutes les exceptions observant des continuations déclarent qu’elles peuvent lever l’ExecutionException.

Interfaces

Event<T,R>

Cette interface fournit un modèle d’événement simple. Les événements produisent des éléments consommés par EventListeners. Le flux des éléments d’événement est contrôlé par l’abonnement EventSubscription.

EventListener<T,R>

Cette interface fournit une méthode simple de gestion des événements. Il permet aux écouteurs d’être inscrits auprès de méthodes à l’aide d’expressions lambda (disponibles dans Java 8). Étant donné que les expressions lambda et les classes anonymes permettent une capture implicite des variables dans l’étendue englobante, il est important de ne pas oublier d’utiliser WeakReferences ou de toujours veiller à appeler EventSubscription.cancel pour garantir un nettoyage correct des ressources.

EventSubscription

Cette interface fournit un abonnement aux événements simple

AsyncOperation.ResultBiConsumer<T,U>

Représente une action à appeler après la fin d’une opération AsyncOperation. Notamment, cette interface fonctionnelle est utilisée lorsque deux arguments d’appel sont utilisés comme avec AsyncOperation.whenComplete.

Il s’agit d’une interface fonctionnelle équivalente à l’interface BiConsumer d’Android

AsyncOperation.ResultBiFunction<T,U,R>

Représente une fonction à appeler après l’exécution d’une opération AsyncOperation. Notamment, cette interface fonctionnelle est utilisée lorsque seuls deux arguments sont nécessaires et qu’un résultat est généré, comme avec AsyncOperation.handleAsync

Il s’agit d’une interface fonctionnelle équivalente à l’interface BiFunction d’Android

AsyncOperation.ResultConsumer<T>

Représente une action à appeler après la fin d’une opération AsyncOperation. Notamment, cette interface fonctionnelle est utilisée lorsqu’un seul argument est nécessaire, comme avec AsyncOperation.thenAccept.

Il s’agit d’une interface fonctionnelle équivalente à l’interface consommateur android

AsyncOperation.ResultFunction<T,R>

Représente une fonction à appeler après l’exécution d’une opération AsyncOperation. Notamment, cette interface fonctionnelle est utilisée quand seul un argument singe est nécessaire et qu’un résultat est produit, comme avec AsyncOperation.thenApply

Il s’agit d’une interface fonctionnelle équivalente à l’interface function d’Android

AsyncOperation.Supplier<T>

Représente une fonction qui fournit une valeur T (pas nécessairement nouvelle/distincte) lorsque vous y êtes invité.

Il s’agit d’une interface fonctionnelle équivalente à l’interface fournisseur d’Android

Énumérations

ConnectedDevicesAccountAddedStatus

Contient les valeurs qui décrivent l’état de l’opération d’ajout de compte

ConnectedDevicesAccountType

Contient des valeurs qui décrivent le type de compte d’utilisateur fourni par Microsoft.

ConnectedDevicesNotificationRegistrationState

Valeurs utilisées pour communiquer l’état de l’inscription cloud.

ConnectedDevicesNotificationRegistrationStatus

Contient les valeurs qui décrivent l’état de l’opération d’inscription de notifcation Les états d’erreur indiquent des conditions temporaires dans lesquelles le développeur de l’application peut vouloir réessayer d’inscrire.

ConnectedDevicesNotificationType

Contient des valeurs qui décrivent le type (service) d’une notification.