com.microsoft.connecteddevices

AsyncOperation<T>

具有 T 类型的未来结果或可能的异常的操作。 此类是 Android API 级别 24 CompletableFuture 类的稍微简化版本

实现标准 Future 接口,并提供基本的延续功能。 有关如何使用此类的详细信息,请参阅 CompletableFuture

CompletedableFuture 和 AsyncOperation 之间的重要区别如下:1。 AsyncOperation 的默认异步执行程序是 Executors.newCachedThreadPool(),而 CompletedableFuture 使用 ForkJoinPool.commonPool()。 2. AsyncOperation 缺少 obtrudeException 和 obtrudeValue 方法。

AsyncOperationWithProgress<T,P>

可通过 Progress 事件提供进度的 AsyncOperation 版本。

ConnectedDevicesAccessTokenInvalidatedEventArgs

ConnectedDevicesAccount 返回,以通知与包含作用域的 ConnectedDevicesAccount 报告令牌错误关联的令牌。 令牌提供程序需要刷新其令牌缓存或可能弹出 UI 以要求用户登录以修复其帐户设置。

ConnectedDevicesAccessTokenRequest

请求满足包含范围的包含 ConnectedDevicesAccount 的访问令牌。 此请求需要通过调用 completeWithAccessToken(@NonNull final String token)completeWithErrorMessage(@NonNull final String error)来完成。

ConnectedDevicesAccessTokenRequestedEventArgs

当需要请求令牌时,由 ConnectedDevicesAccount 触发。 包含 ConnectedDevicesAccessTokenRequest

ConnectedDevicesAccount

此类表示应用已知的单个用户帐户。

ConnectedDevicesAccountManager

为 SDK 中的所有帐户相关功能提供单个入口点。

ConnectedDevicesAddAccountResult
ConnectedDevicesDiagnostics

从连接的设备平台管理诊断信息。 不适用于常规用途。

ConnectedDevicesNotification

表示要由连接设备平台处理的传入通知的对象

ConnectedDevicesNotificationRegistration

此类表示应用的注册与推送通知服务(某些连接设备方案所必需的)。 它将此信息传达给连接的设备平台。

ConnectedDevicesNotificationRegistrationManager

管理每个帐户的 ConnectedDevicesPlatform 的推送通知注册。

ConnectedDevicesNotificationRegistrationResult
ConnectedDevicesNotificationRegistrationStateChangedEventArgs

RemoteSystemAppRegistration State Changed 事件的事件 Args 类。 这用作 ConnectedDevicesPlatform 的一部分,以确保应用程序通过正确的通知机制通知新的 ConnectedDevices 消息。

ConnectedDevicesPlatform

一个类,用于表示连接的设备平台并管理应用与其的连接。

ConnectedDevicesPlatformSettings

允许应用程序开发人员向 ConnectedDevices 平台提供初始设置。

ConnectedDevicesProcessNotificationOperation

向 Rome 平台发出处理通知的结果。

ConnectedDevicesRemoveAccountResult
SdkException

用于从连接的设备平台 SDK 通信失败的异常。 这是一个未检查的异常,将引发意外的平台相关错误。

AsyncOperation.CompletionException

未选中的异常包含导致操作异常完成的异常。

ExecutionException 一样使用,只是取消选中它,以便它可以传播到依赖操作,而无需知道完整的异常集/要求所有异常观察延续声明它们可能会引发 ExecutionException。

接口

Event<T,R>

此接口提供简单的事件模型。 事件生成 EventListeners 使用的项。 事件项流由 EventSubscription 控制。

EventListener<T,R>

此接口提供简单的事件处理方法。 它允许通过 Lambda 表达式(在 Java 8 中提供)将侦听器注册到方法。 由于 lambda 表达式和匿名类允许隐式捕获封闭范围内的变量,因此请务必记住使用 WeakReferences 或始终确保调用 EventSubscription.cancel 以确保正确清理资源。

EventSubscription

此接口提供简单的事件订阅

AsyncOperation.ResultBiConsumer<T,U>

表示在完成 AsyncOperation 后要调用的操作。 值得注意的是,当两个调用参数与 AsyncOperation.whenComplete 一样使用时,将使用此功能接口。

这是与 android 的 BiConsumer 接口等效的功能接口

AsyncOperation.ResultBiFunction<T,U,R>

表示在完成 AsyncOperation 后要调用的函数。 值得注意的是,仅当需要两个参数并生成结果(如 AsyncOperation.handleAsync)时,将使用此函数接口

这是与 android 的 BiFunction 接口等效的功能接口

AsyncOperation.ResultConsumer<T>

表示在完成 AsyncOperation 后要调用的操作。 值得注意的是,仅当需要单个参数(如 AsyncOperation.thenAccept)时,才使用此功能接口。

这是等效于 android 使用者接口的功能接口

AsyncOperation.ResultFunction<T,R>

表示在完成 AsyncOperation 后要调用的函数。 值得注意的是,仅当需要 singe 参数并生成结果(如 AsyncOperation.thenApply 时)使用此功能接口

这是等效于 android 函数接口的功能接口

AsyncOperation.Supplier<T>

表示在被问及时提供 T 值(不一定是新/非重复)的函数。

这是等效于 android 供应商接口的功能接口

枚举

ConnectedDevicesAccountAddedStatus

包含描述添加帐户操作状态的值

ConnectedDevicesAccountType

包含描述Microsoft提供的用户帐户类型的值。

ConnectedDevicesNotificationRegistrationState

用于传达云注册状态的值。

ConnectedDevicesNotificationRegistrationStatus

包含描述通知注册操作状态的值。错误状态指示应用开发人员可能需要重试注册的暂时性条件。

ConnectedDevicesNotificationType

包含描述通知的类型(服务)的值。