Android 4.1 API

API 级别:16

Android 4.1 (JELLY_BEAN) 是该平台的一个升级版本,可提供更出色的性能和更优质的用户体验。它为用户和应用开发者添加了新功能。本文档介绍了对应用开发者而言最重要且最实用的新 API。

作为应用开发者,您可以通过 SDK 管理器获取 Android 4.1,它是一个可在 Android 模拟器中运行的系统映像,也是一个可用于构建应用的 SDK 平台。您应尽快下载该系统映像和平台,以便在 Android 4.1 上构建和测试应用。

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

您可以在 Android 4.1 中使用 API,同时通过在代码中添加条件来支持更低版本,这些条件会在执行 minSdkVersion 不支持的 API 之前检查系统 API 级别。 如需详细了解如何保持向后兼容性,请参阅创建向后兼容界面。

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

应用组件

隔离服务

通过在 <service> 标记中指定 android:isolatedProcess="true",您的 Service 将在它自己的独立用户 ID 进程下运行,该进程本身没有任何权限。

内存管理

新的 ComponentCallbacks2 常量(例如 TRIM_MEMORY_RUNNING_LOW 和 TRIM_MEMORY_RUNNING_CRITICAL)可在系统调用 onLowMemory() 之前,为前台进程提供有关内存状态的更多信息。

新增了 getMyMemoryState(ActivityManager.RunningAppProcessInfo) 方法,可让您检索常规内存状态。

content provider

借助新方法 acquireUnstableContentProviderClient(),您可以访问可能“不稳定”的 ContentProviderClient,这样即使 content provider 崩溃,您的应用也不会崩溃。当您在单独的应用中与 content provider 交互时,此方法非常有用。

动态壁纸

新的 intent 协议可直接启动动态壁纸预览 activity,这样您就可以帮助用户选择动态壁纸,而无需强制他们离开您的应用并浏览主屏幕壁纸选择器。

如需启动动态壁纸选择器,请使用 ACTION_CHANGE_LIVE_WALLPAPER 和一个 extra(将动态壁纸 ComponentName 指定为 EXTRA_LIVE_WALLPAPER_COMPONENT 中的字符串)通过 Intent 调用 startActivity()。

应用堆栈导航

Android 4.1 让您能够更轻松地实现正确的向上导航设计模式。 您只需将 android:parentActivityName 添加到清单文件中的每个 <activity> 元素。当用户按下操作栏中的“向上”按钮时,系统会使用此信息打开相应的 activity(同时还会结束当前 activity)。因此,如果您为每个 activity 声明 android:parentActivityName,则无需使用 onOptionsItemSelected() 方法来处理操作栏的应用图标上的点击事件,系统现在会处理该事件并恢复或创建相应的 activity。

当用户通过“深入探究”intent(例如来自通知或来自其他应用的 intent,如在应用之间导航设计指南中所述)进入应用的某个 activity 时,此功能尤其强大。当用户以这种方式进入您的 activity 时,您的应用可能不会自然地具有可在用户向上导航时恢复的 activity 返回堆栈。不过,当您为 activity 提供 android:parentActivityName 属性时,系统会识别您的应用是否已包含父 activity 的返回堆栈;如果没有,系统会构建一个包含所有父 activity 的合成返回堆栈。

注意:当用户进入应用中的深层 activity 且该 activity 为应用创建新任务时,系统实际上会将父 activity 堆栈插入到该任务中。因此,按返回按钮也会沿着父 activity 堆栈向后导航。

当系统为您的应用创建合成返回堆栈时,它会构建一个基本 Intent,以便为每个父 activity 创建一个新实例。因此,父 activity 不会像用户自然浏览每个 activity 时那样保存状态。如果任何父级 activity 通常会显示依赖于用户上下文的界面,则该上下文信息将会缺失,您应在用户通过堆栈向后导航时提供该信息。例如,如果用户正在音乐应用中查看某个专辑,则向上导航可能会将其带到列出所选音乐类型中所有专辑的 activity。在这种情况下,如果必须创建堆栈,您需要告知父级 activity 当前专辑属于哪种流派,以便父级 activity 可以显示正确的列表,就像用户实际上来自该 activity 一样。如需将此类信息传递给合成父 activity,您必须替换 onPrepareNavigateUpTaskStack() 方法。这会为您提供一个 TaskStackBuilder 对象,该对象由系统创建,用于合成父 activity。TaskStackBuilder 包含系统用于创建每个父 activity 的 Intent 对象。在 onPrepareNavigateUpTaskStack() 的实现中,您可以修改相应的 Intent,以添加父 activity 可用于确定适当上下文并显示适当界面的额外数据。

系统创建 TaskStackBuilder 时,会按照逻辑顺序(从 activity 树的顶部开始)添加用于创建父 activity 的 Intent 对象。因此,添加到内部数组的最后一个 Intent 是当前 activity 的直接父级。如果您想修改 activity 父级的 Intent,请先使用 getIntentCount() 确定数组的长度,然后将该值传递给 editIntentAt()。

如果您的应用结构更复杂,您还可以使用其他几个 API 来处理向上导航的行为,并完全自定义合成返回堆栈。可为您提供额外控制权的部分 API 包括:

onNavigateUp()
替换此方法,以便在用户按下“向上”按钮时执行自定义操作。
navigateUpTo(Intent)
调用此方法可完成当前 activity,并转到所提供的 Intent 指示的 activity。如果该 activity 存在于返回堆栈中,但不是最接近的父级,则当前 activity 与 intent 指定的 activity 之间的所有其他 activity 也会完成。
getParentActivityIntent()
调用此方法可获取将启动当前 activity 的逻辑父项的 Intent。
shouldUpRecreateTask(Intent)
调用此方法可查询是否必须创建合成返回堆栈才能向上导航。如果必须创建合成堆栈,则返回 true;如果相应的堆栈已存在,则返回 false。
finishAffinity()
调用此方法可结束当前 activity 以及与当前 activity 关联且具有相同任务相似性的所有父 activity。 如果您替换了默认行为(例如 onNavigateUp()),则应在向上导航时创建合成返回堆栈时调用此方法。
onCreateNavigateUpTaskStack
如果您需要完全控制合成任务堆栈的创建方式,请替换此方法。如果您想向返回堆栈的 intent 添加额外数据,则应改为替换 onPrepareNavigateUpTaskStack()

不过,大多数应用无需使用这些 API 或实现 onPrepareNavigateUpTaskStack(),只需向每个 <activity> 元素添加 android:parentActivityName 即可实现正确的行为。

多媒体

媒体编解码器

MediaCodec 类提供对底层媒体编解码器的访问权限,以便对媒体进行编码和解码。您可以通过调用 createEncoderByType() 来实例化 MediaCodec 以对媒体进行编码,也可以调用 createDecoderByType() 来对媒体进行解码。这些方法中的每一个都采用您要编码或解码的媒体类型的 MIME 类型,例如 "video/3gpp" 或 "audio/vorbis"。

创建 MediaCodec 的实例后,您可以调用 configure() 来指定媒体格式或内容是否加密等属性。

无论您是要对媒体进行编码还是解码,在创建 MediaCodec 后,其余过程都是相同的。首先,调用 getInputBuffers() 以获取输入 ByteBuffer 对象的数组,并调用 getOutputBuffers() 以获取输出 ByteBuffer 对象的数组。

当您准备好进行编码或解码时,请调用 dequeueInputBuffer() 以获取 ByteBuffer 的索引位置(来自输入缓冲区数组),您应该使用该位置来馈送源媒体。使用源媒体填充 ByteBuffer 后,通过调用 queueInputBuffer() 释放缓冲区的所有权。

同样,对于输出缓冲区,请调用 dequeueOutputBuffer() 以获取 ByteBuffer 的索引位置,您将在该位置接收结果。读取 ByteBuffer 的输出后,通过调用 releaseOutputBuffer() 释放所有权。

您可以通过结合调用 queueSecureInputBuffer() 和 MediaCrypto API(而不是常规 queueInputBuffer())来处理编解码器中的加密媒体数据。

如需详细了解如何使用编解码器,请参阅 MediaCodec 文档。

按提示录制音频

借助新方法 startRecording(),您可以根据 MediaSyncEvent 定义的提示开始录音。 MediaSyncEvent 指定一个音频会话(例如由 MediaPlayer 定义的会话),该会话完成后会触发录音机开始录制。例如,您可以使用此功能播放提示录制会话开始的音频提示音,然后自动开始录制,这样您就不必手动同步提示音和录制开始时间。

定时文本轨道

MediaPlayer 现在可同时处理带内和带外文本轨道。 带内文本轨道作为 MP4 或 3GPP 媒体来源中的文本轨道提供。可以使用 addTimedTextSource() 方法将带外文本轨道添加为外部文本来源。添加所有外部文本轨道来源后,应调用 getTrackInfo() 以获取数据源中所有可用轨道的刷新列表。

如需设置要与 MediaPlayer 搭配使用的轨道,您必须调用 selectTrack(),并使用要使用的轨道的索引位置。

如需在文本轨道可播放时收到通知,请实现 MediaPlayer.OnTimedTextListener 接口并将其传递给 setOnTimedTextListener()。

音效

AudioEffect 类现在支持在捕获音频时使用其他音频预处理类型:

  • 具有 AcousticEchoCanceler 的回声消除器 (AEC) 可从捕获的音频信号中移除从远程方接收的信号。
  • 具有 AutomaticGainControl 的自动增益控制 (AGC) 会自动对捕获信号的输出进行归一化。
  • 具有 NoiseSuppressor 的噪声抑制器 (NS) 可从捕获的信号中消除背景噪声。

您可以使用 AudioEffect 子类之一,将这些预处理器效果应用于使用 AudioRecord 捕获的音频。

注意:并非所有设备都支持这些效果,因此您应始终先通过在相应的音效类上调用 isAvailable() 来检查可用性。

无缝播放

现在,您可以在两个单独的 MediaPlayer 对象之间执行无缝播放。在第一个 MediaPlayer 播放完毕之前的任何时间,调用 setNextMediaPlayer(),Android 会尝试在第一个播放器停止时立即启动第二个播放器。

媒体路由器。新的 API MediaRouter、MediaRouteActionProvider 和 MediaRouteButton 提供了用于选择媒体播放位置的标准机制和界面。

相机

自动对焦移动

通过新接口 Camera.AutoFocusMoveCallback,您可以监听自动对焦移动的变化。您可以使用 setAutoFocusMoveCallback() 注册接口。然后,当相机处于连续自动对焦模式(FOCUS_MODE_CONTINUOUS_VIDEO 或 FOCUS_MODE_CONTINUOUS_PICTURE)时,您会收到对 onAutoFocusMoving() 的调用,该调用会告知您自动对焦是已开始移动还是已停止移动。

相机提示音

MediaActionSound 类提供了一组 API,用于产生由相机或其他媒体操作发出的标准声音。在构建自定义静态相机或摄像机时,您应使用这些 API 播放适当的声音。

如需播放声音,请实例化 MediaActionSound 对象,调用 load() 预加载所需的声音,然后在适当的时间调用 play()。

连接

Android Beam

Android Beam™ 现在支持通过蓝牙传输大型载荷。当您使用新的 setBeamPushUris() 方法或新的回调接口 NfcAdapter.CreateBeamUrisCallback 定义要传输的数据时,Android 会将数据传输委托给蓝牙或其他替代传输方式,以实现更快的传输速度。这对于图片和音频文件等大型载荷特别有用,并且不需要在设备之间进行可见配对。您的应用无需执行任何额外操作即可利用通过蓝牙进行的传输。

setBeamPushUris() 方法接受一个 Uri 对象数组,这些对象指定您要从应用传输的数据。或者,您可以实现 NfcAdapter.CreateBeamUrisCallback 接口,该接口可通过调用 setBeamPushUrisCallback() 为您的 activity 指定。

使用回调接口时,当用户通过 Android Beam 执行分享操作时,系统会调用该接口的 createBeamUris() 方法,以便您定义要在分享时分享的 URI。如果待分享的 URI 可能会因 activity 中的用户上下文而异,则此方法非常有用;而如果待分享的 URI 不会发生变化,并且您可以安全地提前定义这些 URI,则调用 setBeamPushUris() 会很有用。

网络服务发现

Android 4.1 增加了对基于多播 DNS 的服务发现的支持,让您可以通过 Wi-Fi 查找和连接到对等设备提供的服务,例如移动设备、打印机、相机、媒体播放器以及在本地网络上注册的其他设备。

新软件包 android.net.nsd 包含新的 API,可让您在本地网络上广播服务、发现网络上的本地设备以及连接到设备。

如需注册服务,您必须先创建一个 NsdServiceInfo 对象,然后使用 setServiceName()、setServiceType() 和 setPort() 等方法定义服务的各种属性。

然后,您需要实现 NsdManager.RegistrationListener,并将其与 NsdServiceInfo 一起传递给 registerService()。

如需发现网络上的服务,请实现 NsdManager.DiscoveryListener 并将其传递给 discoverServices()。

当 NsdManager.DiscoveryListener 收到有关已找到服务的回调时,您需要通过调用 resolveService() 来解析服务,并向其传递 NsdManager.ResolveListener 的实现,该实现会接收包含所发现服务相关信息的 NsdServiceInfo 对象,从而使您能够发起连接。

WLAN 点对点服务发现

Android 4.1 增强了 WLAN 点对点 API,以支持 WifiP2pManager 中的关联前服务发现。这样,您就可以在连接到某个设备之前,使用 WLAN 点对点按服务发现和过滤附近的设备,而网络服务发现则可让您发现现有已连接网络(例如本地 WLAN 网络)上的服务。

如需通过 Wi-Fi 将您的应用作为服务进行广播,以便其他设备可以发现您的应用并连接到该应用,请使用描述应用服务的 WifiP2pServiceInfo 对象调用 addLocalService()。

如需通过 Wi-Fi 发起对附近的设备的发现,您需要先决定是使用 Bonjour 还是 Upnp 进行通信。如需使用 Bonjour,请先使用 setDnsSdResponseListeners() 设置一些回调监听器,该方法同时接受 WifiP2pManager.DnsSdServiceResponseListener 和 WifiP2pManager.DnsSdTxtRecordListener。如需使用 Upnp,请调用 setUpnpServiceResponseListener(),它接受 WifiP2pManager.UpnpServiceResponseListener。

在开始发现本地设备上的服务之前,您还需要调用 addServiceRequest()。当您传递给此方法的 WifiP2pManager.ActionListener 收到成功回调时,您就可以通过调用 discoverServices() 开始在本地设备上发现服务。

发现本地服务后,您会收到 WifiP2pManager.DnsSdServiceResponseListener 或 WifiP2pManager.UpnpServiceResponseListener 的回调,具体取决于您注册使用的是 Bonjour 还是 Upnp。在任一情况下收到的回调都包含一个表示对等设备的 WifiP2pDevice 对象。

网络用量

借助新方法 isActiveNetworkMetered(),您可以检查设备当前是否连接到按流量计费的网络。通过在执行密集型网络事务之前检查此状态,您可以帮助管理可能需要用户付费的数据流量,并就现在还是稍后(例如,当设备连接到 Wi-Fi 时)执行事务做出明智的决策。

无障碍

无障碍服务 API

Android 4.1 显著扩大了无障碍服务 API 的覆盖范围。现在,您可以通过它构建服务来监控和响应更多输入事件,例如使用 onGesture() 的复杂手势,以及通过向 AccessibilityEvent、AccessibilityNodeInfo 和 AccessibilityRecord 类添加内容来监控和响应其他输入事件。

无障碍服务还可以代表用户执行操作,包括使用 performAction 和 setMovementGranularities 点击、滚动和逐步浏览文本。performGlobalAction() 方法还允许服务执行返回、主屏幕、打开最近用过的应用和通知等操作。

可自定义的应用导航

构建 Android 应用时,您现在可以使用 findFocus() 和 focusSearch() 查找可聚焦元素和输入 widget,并使用 setAccessibilityFocused() 设置焦点,从而自定义导航方案。

更易于访问的微件

借助新的 android.view.accessibility.AccessibilityNodeProvider 类,您可以向无障碍服务公开复杂的自定义视图,以便这些服务以更易于访问的方式呈现信息。android.view.accessibility.AccessibilityNodeProvider 允许具有高级内容(例如日历网格)的用户 widget 为无障碍服务呈现与 widget 的布局结构完全分开的逻辑语义结构。这种语义结构使无障碍服务能够为视力损害的用户提供更实用的互动模型。

复制和粘贴

使用 intent 复制和粘贴

您现在可以使用 setClipData() 方法将 ClipData 对象与 Intent 相关联。 当使用 intent 将多个 content: URI 传输到其他应用时(例如,共享多个文档时),此功能尤为有用。通过这种方式提供的 content: URI 也会遵循 intent 的标志来提供读取或写入权限,从而允许您向 intent 中的多个 URI 授予访问权限。启动 ACTION_SEND 或 ACTION_SEND_MULTIPLE intent 时,intent 中提供的 URI 现在会自动传播到 ClipData,以便接收器可以获得对这些 URI 的访问权限。

支持 HTML 和字符串样式

ClipData 类现在支持带样式的文本(HTML 或 Android 带样式的字符串)。您可以使用 newHtmlText() 将 HTML 样式文本添加到 ClipData。

Renderscript

Renderscript 计算功能已通过以下功能得到增强:

  • 支持在一个脚本中使用多个内核。
  • 支持通过新的脚本 API rsSample,使用计算中的过滤采样器从分配中读取数据。
  • 支持 #pragma 中不同级别的 FP 精度。
  • 支持从计算脚本查询 RS 对象的其他信息。
  • 进行了多项性能改进。

此外,还提供了新的 pragma,用于定义计算 Renderscript 所需的浮点数精度。这样,您就可以在 CPU 路径上启用 NEON 类运算(例如快速向量数学运算),否则无法使用完整的 IEEE 754-2008 标准。

注意:实验性 Renderscript 图形引擎现已弃用。

动画

activity 启动动画

现在,您可以使用缩放动画或您自己的自定义动画启动 Activity。如需指定所需的动画,请使用 ActivityOptions API 构建一个 Bundle,然后将其传递给任何启动 activity 的方法,例如 startActivity()。

ActivityOptions 类包含不同的方法,分别对应您可能希望在 activity 打开时显示的每种动画类型:

makeScaleUpAnimation()
创建一项动画,用于从屏幕上的指定起始位置和指定起始大小放大 activity 窗口。例如,Android 4.1 中的主屏幕在打开应用时会使用此动画。
makeThumbnailScaleUpAnimation()
创建一个动画,该动画从指定位置和提供的缩略图开始放大 activity 窗口。例如,Android 4.1 中的“最近用过的应用”窗口在返回到某个应用时会使用此标志。
makeCustomAnimation()
创建由您自己的资源定义的动画:一个定义 activity 打开时的动画,另一个定义 activity 停止时的动画。

时间动画师

新的 TimeAnimator 通过 TimeAnimator.TimeListener 提供了一种回调机制,可在动画的每一帧通知您。此 Animator 没有时长、插值或对象值设置。监听器的回调会接收每一帧的信息,包括总耗时和自上一动画帧以来的耗时。

界面

通知

在 Android 4.1 中,您可以创建具有更大内容区域、大图片预览、多个操作按钮和可配置优先级的通知。

通知样式

通过新方法 setStyle(),您可以为通知指定三种新样式之一,每种样式都提供更大的内容区域。如需为大内容区域指定样式,请向 setStyle() 传递以下对象之一:

Notification.BigPictureStyle
适用于包含大图片附件的通知。
Notification.BigTextStyle
适用于包含大量文本的通知,例如单封电子邮件。
Notification.InboxStyle
适用于包含字符串列表(例如多封邮件中的摘要)的通知。
通知操作

现在,无论您的通知使用正常样式还是较大样式,都支持在通知消息底部显示最多两个操作按钮。

如需添加操作按钮,请调用 addAction()。此方法接受三个参数:图标的可绘制资源、按钮的文本以及定义要执行的操作的 PendingIntent。

优先级

现在,您可以通过使用 setPriority() 设置优先级,向系统提示通知的重要性,从而影响通知在列表中的顺序。您可以传递 Notification 类中由 PRIORITY_* 常量定义的五个不同优先级之一。默认值为 PRIORITY_DEFAULT,还有两个更高级别和两个更低级别。

高优先级通知通常是用户希望快速响应的内容,例如新的即时通讯、短信或即将发生的活动提醒。低优先级通知包括已过期的日历活动或应用宣传广告等。

系统界面控件

Android 4.0 (Ice Cream Sandwich) 添加了新标志来控制系统界面元素的可见性,例如调暗系统栏的外观或使其在手机上完全消失。Android 4.1 添加了更多标志,让您可以通过调用 setSystemUiVisibility() 并传递以下标志,进一步控制系统界面元素的外观以及与这些元素相关的 activity 布局:

SYSTEM_UI_FLAG_FULLSCREEN
隐藏非关键系统界面(例如状态栏)。 如果您的 activity 在叠加模式下使用操作栏(通过启用 android:windowActionBarOverlay),则此标志还会隐藏操作栏,并在隐藏和显示这两者时使用协调的动画。
SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN
将 activity 布局设置为使用启用 SYSTEM_UI_FLAG_FULLSCREEN 时可用的相同屏幕区域,即使系统界面元素仍然可见也是如此。虽然系统界面会覆盖布局的某些部分,但如果您的应用经常使用 SYSTEM_UI_FLAG_FULLSCREEN 隐藏和显示系统界面,则此方法非常有用,因为它可以避免布局在每次系统界面隐藏或显示时调整为新的布局边界。
SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION
将 activity 布局设置为使用启用 SYSTEM_UI_FLAG_HIDE_NAVIGATION(在 Android 4.0 中添加)时可用的相同屏幕区域,即使系统界面元素仍然可见也是如此。虽然布局的某些部分会被导航栏覆盖,但如果您的应用经常使用 SYSTEM_UI_FLAG_HIDE_NAVIGATION 隐藏和显示导航栏,则此方法非常有用,因为这样可以避免布局在每次导航栏隐藏或显示时调整为新的布局边界。
SYSTEM_UI_FLAG_LAYOUT_STABLE
如果您使用的是 SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN 和/或 SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION,则可能需要添加此标志,以确保在视图上调用 fitSystemWindows() 时,定义的边界与可用屏幕空间保持一致。 也就是说,设置此标志后,即使您隐藏了所有系统界面,fitSystemWindows() 的行为也会像系统界面元素的可见性未发生变化一样。

如需详细了解其他相关的系统界面标志,请参阅 Android 4.0 中添加的标志。

远程视图

GridLayout 和 ViewStub 现在是可远程处理的视图,因此您可以在应用 widget 和通知自定义布局的布局中使用它们。

字体系列

Android 4.1 增加了 Roboto 字体样式的几种变体,总共 10 种变体,它们都可供应用使用。您的应用现在可以访问全套浅色和浓缩变体。

可用的 Roboto 字体变体完整列表如下:

  • 常规
  • 斜体
  • 粗体
  • 粗斜体
  • 浅色
  • 细斜体
  • Condensed regular
  • Condensed italic
  • Condensed bold
  • Condensed 粗斜体

您可以通过将新的 fontFamily 属性与 textStyle 属性结合使用来应用上述任一插值器。

fontFamily 的支持的值包括:

  • "sans-serif"(常规 Roboto)
  • "sans-serif-light"(Roboto Light 字体)
  • "sans-serif-condensed"(Roboto Condensed 字体)

然后,您可以使用 textStyle 值 "bold" 和 "italic" 应用粗体和/或斜体。您可以同时应用这两项,如下所示:android:textStyle="bold|italic"。

您也可以使用 Typeface.create()。 例如 Typeface.create("sans-serif-light", Typeface.NORMAL)。

输入框架

多个输入设备

借助新的 InputManager 类,您可以查询当前连接的输入设备集,并注册以便在添加、更改或移除新设备时收到通知。如果您正在构建一款支持多名玩家的游戏,并且想要检测连接了多少个控制器以及控制器数量何时发生变化,此功能会特别有用。

您可以通过调用 getInputDeviceIds() 查询所有已连接的输入设备。此方法会返回一个整数数组,其中每个整数都是一个不同输入设备的 ID。然后,您可以调用 getInputDevice(),以获取指定输入设备 ID 的 InputDevice。

如果您希望在连接、更改或断开连接新的输入设备时收到通知,请实现 InputManager.InputDeviceListener 接口并将其注册到 registerInputDeviceListener()。

输入控制器振动

如果连接的输入设备具有自己的振动功能,您现在可以通过对 InputDevice 调用 getVibrator(),使用现有的 Vibrator API 控制这些设备的振动。

权限

以下是新权限:

READ_EXTERNAL_STORAGE
提供对外部存储空间的受保护读取权限。在 Android 4.1 中,默认情况下,所有应用仍具有读取权限。在未来的版本中,此行为将发生变化,要求应用使用此权限明确请求读取权限。如果您的应用已请求写入权限,它也会自动获得读取权限。新增了一项开发者选项,用于开启读取权限限制,以便开发者测试其应用在 Android 未来版本中的行为。
android.Manifest.permission.READ_USER_DICTIONARY
允许应用读取用户字典。只有 IME 或字典编辑器(如“设置”应用)才需要此权限。
READ_CALL_LOG
允许应用读取系统的通话记录,其中包含有关来电和去电的信息。
WRITE_CALL_LOG
允许应用修改手机上存储的系统通话记录
android.Manifest.permission.WRITE_USER_DICTIONARY
允许应用向用户字典中写入内容。

设备功能

Android 4.1 包含一项新的功能声明,适用于专门在电视屏幕上显示界面的设备:FEATURE_TELEVISION。如需声明您的应用需要电视界面,请在清单文件中使用 <uses-feature> 元素声明此功能:

<manifest ... >
    <uses-feature android:name="android.hardware.type.television"
                  android:required="true" />
    ...
</manifest>

此功能将“电视”定义为一种典型的 Living Room 电视体验:在大屏幕上显示、用户坐在远处,主流输入形式是类似方向键的设备,通常不通过触摸或鼠标/指控设备。