Android 6.0 API

Android 6.0 (M) 为用户和应用开发者提供了新功能。本文档简要介绍了最值得注意的 API。

开始开发

如需开始构建 Android 6.0 应用,您必须先获取 Android SDK。然后使用 SDK 管理器下载 Android 6.0 SDK 平台和系统映像。

更新目标 API 级别

为了更好地针对搭载 Android 的设备优化您的应用,请将 targetSdkVersion 设置为 "23",在 Android 系统映像上安装您的应用,对其进行测试,然后发布包含此项更改的更新版应用。

您可以使用 Android API,同时通过在代码中添加条件来检查系统 API 级别,然后再执行 minSdkVersion 不支持的 API,从而支持较低版本。 如需详细了解如何保持向后兼容性,请参阅支持不同的平台版本。

如需详细了解 API 级别的工作原理,请参阅什么是 API 级别?

指纹身份验证

此版本提供了新的 API,让您可以在受支持的设备上使用用户的指纹扫描进行身份验证。请将这些 API 与 Android 密钥库系统结合使用。

如需使用指纹扫描对用户进行身份验证,请获取新 FingerprintManager 类的实例并调用 authenticate() 方法。您的应用必须在具有指纹传感器的兼容设备上运行。您必须在应用中实现指纹身份验证流程的界面,并在界面中使用标准 Android 指纹图标。 生物识别验证示例中包含 Android 指纹图标 (c_fp_40px.png)。 如果您正在开发多个使用指纹身份验证的应用,请注意,每个应用都必须单独对用户的指纹进行身份验证。

如需在应用中使用此功能,请先在清单中添加 USE_FINGERPRINT 权限。

<uses-permission
        android:name="android.permission.USE_FINGERPRINT" />
显示指纹身份验证功能的手机

如需查看指纹身份验证的应用实现,请参阅生物识别验证示例。如需了解如何将这些身份验证 API 与其他 Android API 结合使用,请观看指纹和付款 API 视频。

如果您正在测试此功能,请按以下步骤操作:

  1. 安装 Android SDK 工具修订版 24.3(如果您尚未安装)。
  2. 在模拟器中注册一个新指纹,方法是依次前往设置 > 安全 > 指纹,然后按照注册说明进行操作。
  3. 使用模拟器通过以下命令模拟指纹触摸事件。使用同一命令可在锁屏界面或应用中模拟指纹触摸事件。
    adb -e emu finger touch <finger_id>
    

    在 Windows 上,您可能需要先运行 telnet 127.0.0.1 <emulator-id>,然后运行 finger touch <finger_id>。

确认凭据

您的应用可以根据用户上次解锁设备的时间来验证用户身份。此功能让用户无需记住额外的应用专用密码,也让您无需实现自己的身份验证界面。您的应用应将此功能与公钥或密钥实现结合使用,以进行用户身份验证。

如需设置用户成功通过身份验证后可重复使用同一密钥的超时时长,请在设置 KeyGenerator 或 KeyPairGenerator 时调用新的 setUserAuthenticationValidityDurationSeconds() 方法。

避免过度显示重新身份验证对话框 - 您的应用应首先尝试使用加密对象,如果超时,请使用 createConfirmDeviceCredentialIntent() 方法在应用内重新对用户进行身份验证。

应用关联

此版本通过提供更强大的应用链接功能,增强了 Android 的 intent 系统。 借助此功能,您可以将应用与您拥有的网域相关联。基于此关联,平台可以确定用于处理特定网页链接的默认应用,并跳过提示用户选择应用的步骤。如需了解如何实现此功能,请参阅处理应用链接。

应用的自动备份

系统现在会为应用执行自动完整数据备份和恢复。您的应用必须以 Android 6.0(API 级别 23)为目标平台才能启用此行为;您无需添加任何其他代码。 如果用户删除其 Google 账号,其备份数据也会一并删除。如需了解此功能的工作原理以及如何配置要在文件系统上备份的内容,请参阅为应用配置自动备份。

直接分享

手机底部显示“直接分享”功能

此版本提供了相关 API,可让用户直观、快速地进行分享。现在,您可以定义直接分享目标,以便在应用中启动特定 activity。这些直接分享目标会通过分享菜单向用户公开。此功能可让用户与其他应用中的目标对象(例如联系人)分享内容。例如,直接分享目标可能会在另一个社交网络应用中启动一个 activity,让用户能够直接与该应用中的特定好友或社区分享内容。

如需启用直接分享目标,您必须定义一个扩展 ChooserTargetService 类的类。在清单中声明您的服务。在该声明中,指定 BIND_CHOOSER_TARGET_SERVICE 权限和使用 SERVICE_INTERFACE 操作的 intent 过滤器。

以下示例展示了如何在清单中声明 ChooserTargetService。

<service android:name=".ChooserTargetService"
        android:label="@string/service_name"
        android:permission="android.permission.BIND_CHOOSER_TARGET_SERVICE">
    <intent-filter>
        <action android:name="android.service.chooser.ChooserTargetService" />
    </intent-filter>
</service>

对于您要向 ChooserTargetService 公开的每个 activity,请在应用清单中添加一个名为 "android.service.chooser.chooser_target_service" 的 <meta-data> 元素。

<activity android:name=".MyShareActivity"
        android:label="@string/share_activity_label">
    <intent-filter>
        <action android:name="android.intent.action.SEND" />
    </intent-filter>
<meta-data
        android:name="android.service.chooser.chooser_target_service"
        android:value=".ChooserTargetService" />
</activity>

语音互动

此版本提供了一个新的语音互动 API,该 API 与语音操作相结合,可让您在应用中打造对话式语音体验。调用 isVoiceInteraction() 方法,以确定语音操作是否触发了您的 activity。如果是,您的应用可以使用 VoiceInteractor 类来请求用户进行语音确认、从选项列表中进行选择等。

大多数语音互动都源自用户的语音操作。不过,语音互动 activity 也可以在没有用户输入的情况下启动。例如,通过语音互动启动的其他应用也可以发送 intent 来启动语音互动。如需确定您的 activity 是通过用户语音查询还是通过其他语音互动应用启动的,请调用 isVoiceInteractionRoot() 方法。如果另一个应用启动了您的 activity,该方法会返回 false。然后,您的应用可能会提示用户确认他们是否打算执行此操作。

如需详细了解如何实现语音操作,请参阅语音操作开发者网站。

Assist API

此版本为用户提供了一种通过 Google 助理与您的应用互动的新方式。如需使用此功能,用户必须允许助理使用当前上下文。启用后,用户可以在任何应用中通过长按主屏幕按钮来召唤助理。

您的应用可以通过设置 FLAG_SECURE 标志来选择不与 Google 助理分享当前上下文。除了平台传递给助理的标准信息集之外,您的应用还可以使用新的 AssistContent 类分享其他信息。

如需向 Google 助理提供应用中的其他上下文,请按以下步骤操作:

  1. 实现 Application.OnProvideAssistDataListener 接口。
  2. 使用 registerOnProvideAssistDataListener() 注册此监听器。
  3. 如需提供特定于 activity 的上下文信息,请替换 onProvideAssistData() 回调,并视需要替换新的 onProvideAssistContent() 回调。

可合并的存储设备

在此版本中,用户可以采用 SD 卡等外部存储设备。合并外部存储设备会对其进行加密和格式化,使其可以像内部存储设备一样使用。此功能允许用户在存储设备之间移动应用以及这些应用的私有数据。移动应用时,系统会遵循清单中的 android:installLocation 偏好设置。

如果您的应用访问以下 API 或字段,请注意,当应用在内部和外部存储设备之间移动时,它们返回的文件路径会动态更改。 构建文件路径时,强烈建议您始终动态调用这些 API。 请勿使用硬编码的文件路径,也不要保留之前构建的完全限定文件路径。

如需调试此功能,您可以通过运行以下命令,启用对通过 USB On-The-Go (OTG) 线连接到 Android 设备的 U 盘的采用:

$ adb shell sm set-force-adoptable true

通知

此版本针对通知添加了以下 API 变更:

蓝牙触控笔支持

此版本改进了对使用蓝牙触控笔进行用户输入的支持。用户可以将兼容的蓝牙触控笔与手机或平板电脑配对并连接。连接后,来自触摸屏的位置信息会与来自触控笔的压力和按钮信息融合,从而提供比单独使用触摸屏更丰富的表达方式。您的应用可以通过在 activity 中注册 View.OnContextClickListener 和 GestureDetector.OnContextClickListener 对象来监听触控笔按钮按下操作并执行辅助操作。

使用 MotionEvent 方法和常量检测触控笔按钮互动:

改进了低功耗蓝牙扫描

如果您的应用执行低功耗蓝牙扫描,请使用新的 setCallbackType() 方法来指定您希望系统在首次发现或长时间后再次发现与设置的 ScanFilter 匹配的通告数据包时通知回调。这种扫描方法比之前的平台版本中提供的方法更节能。

Hotspot 2.0 Release 1 支持

此版本增加了对 Nexus 6 和 Nexus 9 设备上的 Hotspot 2.0 Release 1 规范的支持。如需在应用中预配 Hotspot 2.0 凭据,请使用 WifiEnterpriseConfig 类的新方法,例如 setPlmn() 和 setRealm()。在 WifiConfiguration 对象中,您可以设置 FQDN 和 providerFriendlyName 字段。新的 isPasspointNetwork() 方法可指示检测到的网络是否代表 Hotspot 2.0 接入点。

4K 显示模式

现在,该平台允许应用请求在兼容的硬件上将显示分辨率升级到 4K 渲染。如需查询当前的物理分辨率,请使用新的 Display.Mode API。如果界面是以较低的逻辑分辨率绘制,并放大到较高的物理分辨率,请注意,getPhysicalWidth() 方法返回的物理分辨率可能与 getSize() 报告的逻辑分辨率不同。

您可以通过设置应用窗口的 preferredDisplayModeId 属性,请求系统在应用运行时更改物理分辨率。如果您想切换到 4K 显示分辨率,此功能会非常有用。在 4K 显示模式下,界面会继续以原始分辨率(例如 1080p)渲染,并放大到 4K,但 SurfaceView 对象可能会以原生分辨率显示内容。

可设置主题的 ColorStateList

现在,在搭载 Android 6.0(API 级别 23)的设备上,ColorStateList 支持主题属性。Resources.getColorStateList() 和 Resources.getColor() 方法已废弃。如果您要调用这些 API,请改为调用新的 Context.getColorStateList() 或 Context.getColor() 方法。这些方法也可在 v4 appcompat 库中使用,只需使用 ContextCompat 即可。

音频功能

此版本增强了 Android 上的音频处理功能,包括:

  • 支持 MIDI 协议,并提供新的 android.media.midi API。使用这些 API 发送和接收 MIDI 事件。
  • 新增了 AudioRecord.Builder 和 AudioTrack.Builder 类,分别用于创建数字音频捕获和播放对象,以及配置音频源和接收器属性以替换系统默认值。
  • 用于关联音频和输入设备的 API 钩子。如果您的应用允许用户通过连接到 Android TV 的游戏控制器或遥控器启动语音搜索,此功能会特别有用。当用户开始搜索时,系统会调用新的 onSearchRequested() 回调。如需确定用户的输入设备是否具有内置麦克风,请从该回调中检索 InputDevice 对象,然后调用新的 hasMicrophone() 方法。
  • 新增了 getDevices() 方法,可让您检索当前连接到系统的所有音频设备的列表。如果您希望系统在音频设备连接或断开连接时通知您的应用,还可以注册 AudioDeviceCallback 对象。

视频功能

此版本为视频处理 API 添加了新功能,包括:

  • 新增了 MediaSync 类,可帮助应用同步呈现音频和视频流。音频缓冲区以非阻塞方式提交,并使用回调返回。它还支持动态播放速度。
  • 新增了 EVENT_SESSION_RECLAIMED 事件,用于指示应用打开的会话已被资源管理器回收。如果您的应用使用 DRM 会话,您应处理此事件,并确保不使用已回收的会话。
  • 新增了 ERROR_RECLAIMED 错误代码,表示资源管理器已回收编解码器使用的媒体资源。出现此异常时,编解码器必须释放,因为它已进入终止状态。
  • 新增了 getMaxSupportedInstances() 接口,用于获取有关支持的并发编解码器实例数上限的提示。
  • 新增了 setPlaybackParams() 方法,用于设置媒体播放速度,以实现快动作或慢动作播放。它还会自动拉伸或加快音频播放速度,以与视频保持同步。

相机功能

此版本包含以下新 API,用于访问相机的手电筒以及对图片进行相机再处理:

Flashlight API

如果相机设备具有闪光灯单元,您可以调用 setTorchMode() 方法来开启或关闭闪光灯单元的手电筒模式,而无需打开相机设备。应用不具有闪光灯单元或相机设备的独占所有权。每当相机设备不可用时,或者当使手电筒保持开启状态的其他相机资源不可用时,手电筒模式都会关闭并变为不可用。其他应用也可以调用 setTorchMode() 来关闭手电筒模式。当最后一个开启手电筒模式的应用关闭时,手电筒模式也会关闭。

您可以通过调用 registerTorchCallback() 方法注册回调,以便在手电筒模式状态发生变化时收到通知。首次注册回调时,系统会立即调用该回调,并提供所有当前已知带闪光灯单元的相机设备的手电筒模式状态。如果手电筒模式成功开启或关闭,系统会调用 onTorchModeChanged() 方法。

Reprocessing API

Camera2 API 经过扩展,可支持 YUV 和不透明专用格式图片再处理。如需确定这些重新处理功能是否可用,请调用 getCameraCharacteristics() 并检查 REPROCESS_MAX_CAPTURE_STALL 键。如果设备支持重新处理,您可以通过调用 createReprocessableCaptureSession() 创建可重新处理的相机拍摄会话,并创建输入缓冲区重新处理请求。

使用 ImageWriter 类将输入缓冲区流连接到相机重新处理输入。如需获取空缓冲区,请遵循以下编程模型:

  1. 调用 dequeueInputImage() 方法。
  2. 将数据填充到输入缓冲区中。
  3. 通过调用 queueInputImage() 方法将缓冲区发送到相机。

如果您将 ImageWriter 对象与 PRIVATE 图片结合使用,您的应用将无法直接访问图片数据。而是通过调用 queueInputImage() 方法,将 PRIVATE 图片直接传递给 ImageWriter,而无需任何缓冲区复制。

ImageReader 类现在支持 PRIVATE 格式的图片流。借助此支持,您的应用可以维护 ImageReader 输出图片的循环图片队列,选择一张或多张图片,然后将其发送到 ImageWriter 以进行相机重新处理。

Android for Work 功能

此版本包含以下适用于 Android for Work 的新 API:

  • 增强了对公司自有、一次性设备的控制:设备所有者现在可以控制以下设置,以改进对公司自有、一次性 (COSU) 设备的管理:
  • 设备所有者静默安装和卸载应用:设备所有者现在可以使用 PackageInstaller API 静默安装和卸载应用,而无需依赖 Google Play for Work。现在,您可以通过设备所有者配置设备,无需用户互动即可提取和安装应用。此功能有助于在不激活 Google 账号的情况下,一键配置自助服务终端或其他类似设备。
  • 静默企业证书访问权限:当应用调用 choosePrivateKeyAlias() 时,在系统提示用户选择证书之前,个人资料所有者或设备所有者现在可以调用 onChoosePrivateKeyAlias() 方法,以静默方式向发出请求的应用提供别名。借助此功能,您可以向受管理的应用授予对证书的访问权限,而无需用户互动。
  • 自动接受系统更新。通过使用 setSystemUpdatePolicy() 设置系统更新政策,设备所有者现在可以自动接受系统更新(例如在自助服务终端设备上),或推迟更新并防止用户在长达 30 天的时间内进行更新。此外,管理员还可以设置必须进行更新的每日时间范围,例如在自助服务终端设备不使用的时段。当有系统更新可用时,系统会检查设备政策控制器应用是否设置了系统更新政策,并据此采取相应措施。
  • 委托证书安装:个人资料所有者或设备所有者现在可以向第三方应用授予调用以下 DevicePolicyManager 证书管理 API 的能力:
  • 一部手机,显示 Android for Work 中的工作状态通知功能
  • 数据用量跟踪。现在,个人资料所有者或设备所有者可以使用新的 NetworkStatsManager 方法查询设置 > 流量使用情况中显示的数据流量使用情况统计信息。系统会自动向个人资料所有者授予查询其管理的个人资料中数据的权限,而设备所有者则可以访问受管理的主要用户的使用情况数据。
  • 运行时权限管理:

    配置文件所有者或设备所有者可以使用 setPermissionPolicy() 为所有应用的所有运行时请求设置权限政策,以提示用户授予权限,或自动静默授予或拒绝权限。如果设置了后一项政策,用户将无法在设置中的应用权限屏幕内修改由个人资料所有者或设备所有者所做的选择。

  • “设置”中的 VPN:VPN 应用现在会显示在设置 > 更多 > VPN 中。 此外,现在,伴随 VPN 使用而显示的通知会因 VPN 的配置方式而异。对于资料所有者,通知会根据 VPN 是为受管资料、个人资料还是两者配置而有所不同。对于设备所有者,通知会具体说明是否为整个设备配置了 VPN。
  • 工作状态通知:现在,只要受管理个人资料中的应用在前台有活动,状态栏中就会显示公文包图标。此外,如果设备解锁后直接进入受管资料中应用的 activity,系统会显示消息框,通知用户他们位于工作资料中。