Android 10 功能和 API

Android 10 为用户和开发者引入了一些出色的特性和功能。本文重点介绍面向开发者的功能。

如需了解 API，请阅读 API 差异报告或访问 Android API 参考文档，查找“在 API 级别 29 中添加”的 API。此外，请务必查看 Android 10 行为变更（针对以 API 级别 29 为目标平台的应用和所有应用）以及隐私权变更，以了解平台变更可能会在哪些方面影响您的应用。

安全增强功能

Android 10 引入了多项安全功能，详见以下各部分的摘要。

改进了生物识别身份验证对话框

Android 10 对生物识别身份验证支持进行了以下改进：

• 添加了针对生物识别身份验证功能的检查。
• 一种后备机制，如果用户无法使用生物识别输入进行身份验证，则可以使用设备 PIN 码、图案或密码进行身份验证。
• 一个提示，用于告知系统在用户使用隐式生物识别模式进行身份验证后不要求用户确认。例如，您可以告知系统，在用户使用人脸身份验证进行身份验证后无需进一步确认。

直接从 APK 运行嵌入式 DEX 代码

从 Android 10 开始，您可以告知平台直接从应用的 APK 文件中运行嵌入式 DEX 代码。如果攻击者曾设法篡改了设备上本地编译的代码，此选项有助于防止此类攻击。

如需了解详情，请参阅直接从 APK 运行嵌入式 DEX 代码。

TLS 1.3 支持

Android 10 增加了对 TLS 1.3 的支持。TLS 1.3 是 TLS 标准的主要修订版本，它提升了性能和安全性。我们的基准测试表明，与 TLS 1.2 相比，使用 TLS 1.3 可以将建立安全连接的速度提高 40%。

如需详细了解我们的 TLS 1.3 实现，请参阅“适用于所有应用的行为变更”页面中的“TLS”部分。

公共 Conscrypt API

从 Android 10 开始，Conscrypt 安全提供程序包含用于 TLS 功能的公共 API。

android.net.ssl 下的类集合包含一些静态方法，可用于访问常规 javax.net.ssl API 不提供的功能。这些类的名称可推断为相应 javax.net.ssl 类的复数形式。例如，在 javax.net.ssl.SSLSocket 实例上运行的代码可以改为使用 SSLSockets 中的方法。

注意 ：如果您仍在使用反射访问 TLS 功能，请改用公共 API。这是因为我们计划对非 SDK 接口施加进一步限制。

连接功能

Android 10 包含一些与网络和连接相关的改进。

WLAN 网络连接 API

Android 10 增加了对点对点连接的支持。借助此功能，应用可以使用 WifiNetworkSpecifier 来提示用户更改设备连接到的接入点，以描述所请求网络的属性。点对点连接用于非网络提供目的，例如 Chromecast 和 Google Home 硬件等辅助设备的引导配置。

如需了解详情，请参阅适用于点对点连接的 Wi-Fi Network Request API。

WLAN 网络建议 API

Android 10 增加了对应用提示用户连接到 Wi-Fi 接入点的支持。您可以提供关于要连接到哪个网络的建议。平台最终会根据来自您的应用和其他应用的输入来选择要接受的接入点。

如需详细了解此功能，请参阅 Wi-Fi 建议。

改进了 WLAN 高性能和低延迟模式

Android 10 允许您为底层调制解调器提供提示，以最大限度地缩短延迟。

Android 10 扩展了 Wi-Fi Lock API，以有效支持高性能模式和低延迟模式。对于高性能和低延迟模式，Wi-Fi 节电功能处于停用状态，并且可以在低延迟模式下进一步优化延迟，具体取决于调制解调器支持。

仅当获取锁的应用在前台运行且屏幕处于开启状态时，系统才会启用低延迟模式。低延迟模式对于实时移动游戏应用尤其有用。

DNS 解析器中的专用查找

Android 10 使用明文查找和“通过传输层安全协议 (TLS) 执行 DNS”模式，增加了对专用 DNS 查找的原生支持。以前，平台 DNS 解析器仅支持 A 和 AAAA 记录，这些记录仅允许查找与名称关联的 IP 地址，但不支持任何其他记录类型。DnsResolver API 提供通用的异步解析，使您能够查找 SRV、NAPTR 和其他记录类型。请注意，解析响应由应用负责执行。

对于基于 NDK 的应用，请参阅 android_res_nsend。

Wi-Fi Easy Connect

借助 Android 10，您可以使用 Easy Connect 为对等设备配置 Wi-Fi 凭据，以替代已弃用的 WPS。应用可以使用 ACTION_PROCESS_WIFI_EASY_CONNECT_URI intent 将 Easy Connect 集成到其设置和配置流程中。

如需详细了解此功能，请参阅 Wi-Fi Easy Connect。

Wi-Fi Direct connection API

在 Android 10 中，WifiP2pConfig 和 WifiP2pManager API 类进行了更新，以支持使用预定信息快速与 Wi-Fi 直连建立连接的功能。此类信息通过蓝牙或 NFC 等边信道分享。

以下代码示例展示了如何使用预先确定的信息创建群组：

Kotlin

val manager = getSystemService(Context.WIFI_P2P_SERVICE) as WifiP2pManager
val channel = manager.initialize(this, mainLooper, null)

// prefer 5G band for this group
val config = WifiP2pConfig.Builder()
    .setNetworkName("networkName")
    .setPassphrase("passphrase")
    .enablePersistentMode(false)
    .setGroupOperatingBand(WifiP2pConfig.GROUP_OWNER_BAND_5GHZ)
    .build()

// create a non-persistent group on 5GHz
manager.createGroup(channel, config, null)

Java

WifiP2pManager manager = (WifiP2pManager) getSystemService(Context.WIFI_P2P_SERVICE);
Channel channel = manager.initialize(this, getMainLooper(), null);

// prefer 5G band for this group
WifiP2pConfig config = new WifiP2pConfig.Builder()
.setNetworkName("networkName")
.setPassphrase("passphrase")
.enablePersistentMode(false)
.setGroupOperatingBand(WifiP2pConfig.GROUP_OWNER_BAND_5GHZ)
.build();

// create a non-persistent group on 5GHz
manager.createGroup(channel, config, null);

如需使用凭据加入群组，请将 manager.createGroup() 替换为以下内容：

Kotlin

manager.connect(channel, config, null)

Java

manager.connect(channel, config, null);

蓝牙 LE 连接导向型频道 (CoC)

借助 Android 10，您的应用可以使用 BLE CoC 连接在两个 BLE 设备之间传输更大的数据流。此接口抽象化了蓝牙和连接机制，以简化实现。

电话功能

Android 10 包含一些与电话相关的改进。

通话质量方面的改进

Android 10 新增了一项功能，可在支持该功能的设备上收集进行中的 IP 多媒体子系统 (IMS) 通话质量的相关信息，包括与网络进行通话的质量。

选接电话和来电显示

Android 10 可让您的应用将不在用户通讯录中的来电识别为潜在骚扰电话，并代表用户以静默方式拒接骚扰电话。系统会在通话记录中将这些被屏蔽的来电的相关信息记录为已屏蔽的来电，以便用户更清楚地了解何时有未接来电。使用此 API，不需要从用户那里获取 READ_CALL_LOG 权限就可以提供选接电话和来电显示功能。

Call Redirection Service API

Android 10 更改了来电 intent 的处理方式。NEW_OUTGOING_CALL 广播已废弃，取而代之的是 CallRedirectionService API。CallRedirectionService API 提供了供您修改 Android 平台去电的接口。例如，第三方应用可能会取消呼叫并通过 VoIP 重新路由呼叫。

在外部存储设备中创建文件的相关改进

除了引入分区存储之外，Android 10 还增加了以下与外部存储相关的功能：

• 您可以使用 IS_PENDING 标志授予应用对写入磁盘的媒体文件的独占访问权限。
• 如果您知道应该在哪个具体位置存储文件，可以提示系统在何处存储新写入的文件。
• 每个外部存储设备都有唯一的卷名称。

媒体和图形

Android 10 引入了以下媒体和图形方面的新功能和 API：

共享音频输入

Android 10 增加了两个应用同时共享音频输入的功能。如需了解完整信息，请参阅共享音频输入。

捕获播放的音频

Android 10 可让应用捕获其他应用播放的音频。如需了解完整信息，请参阅捕获播放的音频。

MediaStyle 通知中的拖动条

从 Android 10 开始，MediaStyle 通知会显示拖动条。拖动条会显示 PlaybackState.getPosition() 中的播放进度；在某些情况下，拖动条可用于跳转到正在播放的节目中的某个位置。拖动条的外观和行为受以下规则的控制：

• 如果存在处于活跃状态的 MediaSession，并且其时长（由 MediaMetadata.METADATA_KEY_DURATION 指定）大于零，则会显示拖动条。这意味着该栏不会针对不确定的流（例如直播和电台广播）显示。
• 如果会话实现了 ACTION_SEEK_TO，则用户可以通过拖动该拖动条来控制播放位置。

原生 MIDI API

借助 Android Native MIDI API(AMidi)，应用开发者可以使用 C/C++ 代码发送和接收 MIDI 数据、与其 C/C++ 音频/控制逻辑进行更紧密的集成，并最大限度地减少对 JNI 的需求。

有关详情，请参阅 Android Native MIDI API。

MediaCodecInfo 方面的改进

Android 10 向 MediaCodecInfo 添加了一些方法，用于显示有关编解码器的更多信息。

如需了解详情，请参阅媒体编解码器。

Thermal API

当设备过热时，它们可能会限制 CPU 和/或 GPU，而这可能会以意想不到的方式影响应用和游戏。使用复杂图形、大量计算或持续网络活动的应用更有可能遇到问题，并且问题可能会因芯片组和核心频率、集成级别以及设备包装和外形规格而异。

在 Android 10 中，应用和游戏可以使用 Thermal API 监控设备变化，并采取措施维持低功耗，以恢复正常温度。应用在 PowerManager 中注册监听器，系统通过该监听器报告持续的热状态，热状态的范围从轻度和中度到严重、严重、紧急和关机。

当设备报告热应力时，应用和游戏可以通过减少持续性活动来提供帮助，从而减少各种方式的耗电量。例如，流媒体应用可以降低分辨率/比特率或网络流量，相机应用可以停用闪光灯或密集型图片增强，游戏可以降低帧速率或多边形纹理的旋转，媒体应用可以降低扬声器音量，地图应用可以关闭 GPS。

Thermal API 需要新的设备 HAL 层，目前在搭载 Android 10 的 Pixel 设备上受支持。我们正在与设备制造商合作伙伴合作，以尽快为生态系统提供广泛支持。

摄像头和图片

Android 10 引入了以下与摄像头和图片相关的新功能：

单色摄像头支持

Android 9（API 级别 28）首次引入了单色摄像头功能。Android 10 为单色摄像头支持增加了几项增强功能：

• 增加了对 Y8 流格式的支持，以提高内存效率。
• 支持单色原始 DNG 捕获。
• 引入了 MONO 和 NIR CFA 枚举，以区分常规单色摄像头和近红外摄像头。

您可以使用此功能来捕捉原生单色图片。逻辑多摄像头设备可以使用单色摄像头作为物理子摄像头以实现更好的弱光图像质量。

动态深度格式

从 Android 10 开始，相机可以使用名为动态深度格式 (DDF) 的新架构将图片的深度数据存储在单独的文件中。应用可以请求 JPG 图片及其深度元数据，利用该信息在后期处理中应用所需的模糊处理效果，而无需修改原始图片数据。

如需了解此格式的规范，请参阅动态深度格式。

高效率图片文件格式

高效率图片文件 (HEIF) 格式是一种标准的图片和视频格式，与其他文件格式相比，它的编码质量更高，文件大小更小。

如需详细了解此文件格式，请参阅 HEIC。

多摄像头方面的改进

Android 9（API 级别 28）中引入了将多个摄像头融合成单个逻辑摄像头的功能，Android 10 改进了此功能。Camera2 API 中添加了以下内容：

• isSessionConfigurationSupported(SessionConfiguration sessionConfig) - 使您能够查询传递的会话配置是否可以用于创建相机拍摄会话。

• LOGICAL_MULTI_CAMERA_ACTIVE_PHYSICAL_ID - 使您能够确定为逻辑摄像头设备提供支持的活跃物理摄像头的 ID。您可以使用返回的 ID 来请求逻辑信息流和物理子摄像头信息流，以提高功耗。

无障碍服务 API

Android 10 引入了以下新的无障碍服务功能和 API：

AccessibilityNodeInfo 输入键标记

从 Android 10 开始，您可以调用 isTextEntryKey() 来确定指定的 AccessibilityNodeInfo 是否表示属于键盘或拨号键盘的文本输入键。

无障碍对话框语音反馈

如果用户需要执行无障碍快捷方式来启动无障碍服务，Android 10 允许对话框在服务请求时附带文字转语音提示。

启用手势导航时的无障碍快捷方式

在 Android 10 中启用手势导航功能后，“无障碍”按钮将不可见或不可选择。如需访问“无障碍服务”菜单，用户必须执行以下某项手势：

• 双指向上滑动。
• 双指向上滑动并按住。

物理键盘的无障碍快捷方式

在 Android 10 中，用户可以通过物理键盘来触发无障碍快捷方式，只需按 Ctrl+Alt+Z 即可。

软键盘控制器增强功能

在 Android 10 中，无障碍服务可以请求显示软键盘，即使设备检测到连接了硬键盘也是如此。用户可以替换此行为。

用户定义的无障碍服务超时

Android 10 引入了 getRecommendedTimeoutMillis() API。此方法可支持用户定义的交互式和非交互式界面元素的超时。返回值受用户偏好设置和无障碍服务 API 的影响。

自动填充方面的改进

Android 10 包含对自动填充服务的以下改进。

与兼容性相关的自动填充请求

您可以使用 FillRequest.FLAG_COMPATIBILITY_MODE_REQUEST 标志来确定是否通过兼容模式生成了自动填充请求。

同时保存用户名和密码

通过使用 SaveInfo.FLAG_DELAY_SAVE 标志，您可以支持应用使用多个 activity 显示用户名、密码和其他字段的情况。

用户与保存界面的互动

您可以在保存对话框中显示和隐藏密码字段，方法是在该对话框中设置操作监听器，并更改相应密码远程视图的可见性。

支持更新数据集

自动填充可以更新现有的密码。例如，如果用户已经存储了密码，然后又保存了新密码，则自动填充功能会提示用户更新现有密码，而不是保存新密码。

字段分类方面的改进

Android 10 包含对 Field Classification API 的以下改进。

UserData.Builder 构造函数

UserData.Builder 构造函数已更改，以更好地与 Builder 模式保持一致。

允许将一个值映射到多种类别 ID

在 Android 10 中使用 UserData.Builder 时，您现在可以将一个值映射到多种类别 ID。在之前的版本中，如果多次添加某个值，则会抛出异常。

改进了对信用卡号码的支持

字段分类现在可以检测四位数作为信用卡号的最后四位数。

支持特定于应用的字段分类

Android 10 添加了 FillResponse.setUserData()，可让您设置会话期间特定于应用的用户数据。这有助于自动填充服务检测包含应用专属内容的字段的类型。

界面和系统控件

Android 10 提供界面方面的以下改进：

支持 JVMTI PopFrame 功能

Android 10 增加了对 Android JVMTI 实现中的 can_pop_frames 功能的支持。调试时，借助此功能，您可以在断点暂停并调整函数的局部变量、全局变量或实现后重新运行函数。如需了解详情，请参阅 Oracle 的 Pop Frame 参考页面。

Surface Control API

Android 10 提供了一个 SurfaceControl API，用于对系统合成器 (SurfaceFlinger) 进行低级访问。对于大多数用户来说，SurfaceView 是利用该合成器的正确方法。SurfaceControl API 在某些情况下会很有用，例如：

• 同步多个表面
• 跨进程的表面嵌入
• 底层生命周期管理

SurfaceControl API 在 SDK 和 NDK 绑定中都可用。NDK 实现包含一个用于与合成器手动交换缓冲区的 API。这为遇到 BufferQueue 限制的用户提供了一种替代方案。

WebView 挂起渲染程序检测

Android 10 引入了 WebViewRenderProcessClient 抽象类，应用可以使用该类检测 WebView 是否无响应。如需使用此类，请执行以下操作：

1. 定义您自己的子类并实现其 onRenderProcessResponsive() 和 onRenderProcessUnresponsive() 方法。
2. 将 WebViewRenderProcessClient 的实例附加到一个或多个 WebView 对象。
3. 如果 WebView 无响应，系统会调用客户端的 onRenderProcessUnresponsive() 方法，并传递 WebView 和 WebViewRenderProcess。（如果 WebView 是单进程，则 WebViewRenderProcess 参数为 null。）您的应用可以采取适当的操作，例如向用户显示一个对话框，询问他们是否要停止呈现过程。

如果 WebView 仍然无响应，系统会定期调用 onRenderProcessUnresponsive()（不超过每 5 秒一次），但不会执行任何其他操作。如果 WebView 再次无响应，系统只会调用 onRenderProcessResponsive() 一次。

设置面板

Android 10 引入了设置面板，这是一个 API，可让应用在其自身的上下文中向用户显示设置。这样一来，用户无需转到设置来更改 NFC 或移动数据等设置，即可使用应用。

图 1. 用户尝试在设备未连接到网络时打开网页。Chrome 弹出互联网连接设置面板...

图 2. 用户无需离开 Chrome 应用即可开启 Wi-Fi 并选择网络。

例如，假设用户在设备处于飞行模式时打开网络浏览器。在 Android 10 之前，该应用只能显示一条通用消息，要求用户打开设置以恢复连接。在搭载 Android 10 的设备上，浏览器应用可以显示一个内嵌面板，其中显示了飞行模式、Wi-Fi（包括附近的网络）和移动数据等关键连接设置。借助此面板，用户无需离开应用即可恢复连接。

如需显示设置面板，请触发具有以下某个 Settings.Panel 操作的 intent：

Kotlin

val panelIntent = Intent(Settings.Panel.settings_panel_type)
startActivityForResult(panelIntent)

Java

Intent panelIntent = new Intent(Settings.Panel.settings_panel_type);
startActivityForResult(panelIntent);

settings_panel_type 可以是以下项之一：

ACTION_INTERNET_CONNECTIVITY

显示与互联网连接相关的设置，例如飞行模式、WLAN 和移动数据。

ACTION_WIFI

显示 Wi-Fi 设置，但不显示其他连接设置。这对于需要 Wi-Fi 连接才能执行大量上传或下载的应用非常有用。

ACTION_NFC

显示与近距离无线通信(NFC) 相关的所有设置。

ACTION_VOLUME

显示所有音频流的音量设置。

共享功能方面的改进

Android 10 为共享功能提供了多项改进：

Sharing Shortcuts API

Sharing Shortcuts API 取代了 Direct Share API。

通过 Shared Shortcuts API，应用可以提前发布直接共享目标，而不是被动地按需检索结果。这就是 ShortcutManager 的工作原理。由于这两个 API 类似，因此我们扩展了 ShortcutInfo API，以便您更轻松地使用这两个功能。借助 Shared Shortcuts API，您可以直接为共享目标分配类别或人员。在同一应用更新共享目标或该应用被卸载之前，这些共享目标会一直保留在系统中。

旧版“直接共享”机制仍然有效，但使用该机制的应用的优先级低于使用 Shared Shortcuts API 的应用。

ShortcutInfo.Builder 添加并增强了方法，以提供有关共享目标的更多信息。

直接共享目标

您可以发布一个动态快捷方式作为直接共享目标。 请参阅发布直接共享目标。

ShortcutManagerCompat 是一个新的 AndroidX API，能够向后兼容旧版 DirectShare API。这是发布共享目标的首选方式。

预览文本

当应用共享文本内容时，它可以在 Sharesheet 界面中显示相应内容的可选预览。

请参阅添加富文本预览

了解详情

如需详细了解应用如何共享数据，请参阅将简单的数据发送到其他应用和从其他应用接收简单的数据

深色主题

Android 10 提供了一种深色主题，既会应用于 Android 系统界面，也会应用于设备上运行的应用。如需了解完整信息，请参阅深色主题。

前台服务类型

Android 10 引入了 foregroundServiceType XML 清单属性，您可以将其包含在多项特定服务的定义中。虽然很少适用，但您可以为一项特定服务分配多种前台服务类型。

下表显示了不同的前台服务类型，以及适合声明特定类型的服务：

前台服务类型	应声明相应类型的服务的示例使用情形
connectedDevice	监控穿戴式设备健身跟踪器
dataSync	从网络下载文件
location	继续执行用户发起的操作
mediaPlayback	播放有声读物、播客或音乐
mediaProjection	简短地录屏
phoneCall	处理正在进行的通话

Kotlin

Android 10 对 Kotlin 开发进行了以下更新。

libcore API 的可空性注释

Android 10 扩大了 SDK 中针对 libcore API 的可为 null 性注解的覆盖范围。借助这些注解，在 Android Studio 中使用 Kotlin 或 Java null 性分析的应用开发者在与这些 API 交互时可以获得 null 性信息。

通常，Kotlin 中的可为 null 性合同违规行为会导致编译错误。为了确保与现有代码兼容，系统只会添加 @RecentlyNullable 和 @RecentlyNonNull 注解。这意味着可为 null 性违规行为导致的是警告，而不是错误。

此外，Android 9 中添加的任何 @RecentlyNullable 或 @RecentlyNonNull 注解都将分别更改为 @Nullable 和 @NonNull。这意味着，在 Android 10 及更高版本中，可为 null 性违规行为会导致错误，而不是警告。

如需详细了解注解方面的变更，请参阅 Android 开发者博客中的 Android Pie SDK 现已更适用于 Kotlin一文。

NDK

Android 10 包含 NDK 方面的以下变更。

改进了文件描述符所有权的调试

Android 10 增加了 fdsan，它可以帮助您更轻松地查找和修复文件描述符所有权问题。

与错误处理文件描述符所有权相关的错误（往往表现为 use-after-close 和 double-close）类似于内存分配 use-after-free 和 double-free bug，但往往更难以诊断和修复。fdsan 会尝试通过强制执行文件描述符来检测和/或防止文件描述符管理不当。

如需详细了解与这些问题相关的崩溃，请参阅 fdsan 检测到的错误。 如需详细了解 fdsan，请参阅关于 fdsan 的 Googlesource 页面。

ELF TLS

使用 API 级别 29 及更高版本的 NDK 构建的应用可以使用 ELF TLS，而非 emutls。新增了对动态和静态链接器的支持，以支持这种处理线程局部变量的方法。

对于为 API 级别 28 及更低级别构建的应用，我们为 libgcc/compiler-rt 实现了一些改进，以解决一些 emutls 问题。

如需了解详情，请参阅面向 NDK 开发者的 Android 变更。

运行时

Android 10 包含运行时方面的以下变更。

触发基于 Mallinfo 的垃圾回收

当小型平台 Java 对象引用 C++ 堆中的大型对象时，通常只有在收集并（例如完成）Java 对象时，才能回收 C++ 对象。在之前的版本中，平台会估算与 Java 对象相关联的许多 C++ 对象的大小。此估算并非始终准确无误，并且偶尔会导致内存用量大幅增加，因为平台无法按预期进行垃圾回收。

在 Android 10 中，垃圾回收器 (GC) 会跟踪系统 malloc() 分配的堆的总大小，以确保较大的 malloc() 分配始终包含在可触发 GC 的计算中。因此，与 Java 执行交错大量 C++ 分配的应用可能会出现垃圾回收频率增加的情况。其他应用的频率则可能会略有下降。

测试和调试

Android 10 包含测试和调试方面的以下改进。

改进了设备上系统跟踪功能

从 Android 10 开始，您可以在执行设备端系统轨迹时指定轨迹的大小和时长限制。在您指定任一值后，系统会执行长期跟踪，并在记录跟踪时定期将跟踪缓冲区复制到目标文件。在达到您指定的数据量或时长限制时，跟踪就会完成。

您可以使用这些附加参数来测试与使用标准跟踪记录测试不同的用例。例如，您可能正在诊断一个仅在应用长时间运行后才会发生的性能 bug。在这种情况下，您可以记录一整天的长时间跟踪，然后分析 CPU 调度程序、磁盘活动、应用线程以及报告中的其他数据，以帮助您确定 bug 的原因。

在 Android 10 及更高版本中，轨迹文件会以 Perfetto（一个用于性能检测和跟踪的开源项目）打开的格式保存。您可以将 Perfetto 跟踪文件转换为 Systrace 格式。

TextClassifier 方面的改进

Android 10 在 TextClassifier 接口中提供了额外的文本分类功能。

语言检测

detectLanguage() 方法的工作方式与先前已有的分类方法类似。它会接收 TextLanguage.Request 对象并返回 TextLanguage 对象。

TextLanguage 对象由一系列有序对组成。每个对都包含分类的语言区域和相应的置信度分数。

建议采取的对话操作

suggestConversationActions() 方法的工作方式与现有分类方法类似。它会接收 ConversationActions.Request 对象并返回 ConversationActions 对象。

ConversationActions 对象由一系列 ConversationAction 对象组成。每个 ConversationAction 对象都包含一项可能的建议操作及其置信度分数。

通知中的智能回复/操作

Android 9 引入了在通知中显示建议的回复的功能。Android 10 扩展了此功能，添加了基于 intent 的建议操作。此外，平台能够自动生成这些建议。应用仍然可以提供自己的建议，或选择退出系统生成的建议。

用于生成这些回复的 API 是 TextClassifier 的一部分，在 Android 10 中也已直接提供给开发者。如需了解详情，请参阅“TextClassifier 方面的改进”部分。

如果您的应用提供自己的建议，平台不会生成任何自动建议。如果您不希望应用通知显示任何建议的回复或操作，可以使用 setAllowGeneratedReplies() 和 setAllowSystemGeneratedContextualActions() 选择停用系统生成的回复和操作。