API 级别:19
Android 4.4 (KITKAT) 是 Android 平台的新版本,为用户和应用开发者提供了新功能。本文档简要介绍了最值得注意的新 API。
作为应用开发者,您应尽快从 SDK 管理器下载 Android 4.4 系统映像和 SDK 平台。如果您没有搭载 Android 4.4 的设备来测试应用,请使用 Android 4.4 系统映像在 Android 模拟器上测试应用。 然后,针对 Android 4.4 平台构建应用,开始使用最新的 API。
更新目标 API 级别
为了更好地针对搭载 Android 4.4 的设备优化应用,您应将 targetSdkVersion 设置为 "19",将其安装在 Android 4.4 系统映像上,进行测试,然后发布包含此更改的更新。
您可以在 Android 4.4 中使用 API,同时通过在代码中添加条件来检查系统 API 级别,然后再执行 minSdkVersion 不支持的 API,从而支持旧版本。如需详细了解如何保持向后兼容性,请参阅支持不同的平台版本。
如需详细了解 API 级别的工作原理,请参阅什么是 API 级别?
重要行为变更
如果您之前发布过 Android 应用,请注意,您的应用可能会受到 Android 4.4 中变更的影响。
如果您的应用从外部存储空间读取数据…
在 Android 4.4 上运行时,除非您的应用具有 READ_EXTERNAL_STORAGE 权限,否则无法读取外部存储空间中的共享文件。也就是说,如果没有该权限,将无法再访问 getExternalStoragePublicDirectory() 返回的目录中的文件。不过,如果您只需要访问由 getExternalFilesDir() 提供的应用专属目录,则不需要 READ_EXTERNAL_STORAGE 权限。
如果您的应用使用 WebView…
您的应用在 Android 4.4 上运行时,其行为可能会有所不同,尤其是当您将应用的 targetSdkVersion 更新为“19”或更高版本时。
WebView 类和相关 API 的底层代码已升级,现在基于 Chromium 源代码的现代快照。这带来了各种性能改进、对新 HTML5 功能的支持,以及对 WebView 内容远程调试的支持。此次升级范围广泛,这意味着如果您的应用使用 WebView,其行为在某些情况下可能会受到影响。虽然已知的行为变更都有记录,并且大多数情况下只有在您将应用的 targetSdkVersion 更新为“19”或更高版本时才会影响您的应用(新的 WebView 在“Quirks 模式”下运行,以便在以目标 API 级别 18 及更低级别为目标平台的应用中提供一些旧版功能),但您的应用仍有可能依赖于先前版本 WebView 的未知行为。
因此,如果您的现有应用使用 WebView,请务必尽快在 Android 4.4 上进行测试,并参阅迁移到 Android 4.4 中的 WebView,了解当您将 targetSdkVersion 更新为“19”或更高版本时,您的应用可能会受到怎样的影响。
如果您的应用使用 AlarmManager…
当您将应用的 targetSdkVersion 设置为“19”或更高版本时,您使用 set() 或 setRepeating() 创建的闹钟将不精确。
为了提高能效,Android 现在会将所有应用中在合理相似的时间发生的闹钟分批处理,以便系统唤醒设备一次(而不是多次)来处理每个闹钟。
如果您的闹钟未与确切的时钟时间相关联,但仍需要在特定时间范围(例如下午 2 点到 4 点之间)内调用闹钟,则可以使用新的 setWindow() 方法,该方法接受闹钟的“最早”时间以及系统应在最早时间之后调用闹钟的“时间范围”。
如果您的闹钟必须固定到确切的时钟时间(例如,对于日历活动提醒),则可以使用新的 setExact() 方法。
这种不精确的批处理行为仅适用于更新后的应用。如果您已将 targetSdkVersion 设置为“18”或更低,则在 Android 4.4 上运行时,闹钟的行为将继续与之前版本中的行为相同。
如果您的应用使用 ContentResolver 同步数据…
当您将应用的 targetSdkVersion 设置为“19”或更高版本时,使用 addPeriodicSync() 创建同步将在默认弹性间隔(大约为您指定周期的 4%)内执行同步操作。例如,如果轮询频率为 24 小时,则同步操作可能会在每天大约 1 小时的时间范围内进行,而不是每天在完全相同的时间进行。
如需为同步操作指定您自己的弹性间隔,您应开始使用新的 requestSync() 方法。如需了解详情,请参阅下文关于同步适配器的部分。
此弹性间隔行为仅适用于更新后的应用。如果您已将 targetSdkVersion 设置为“18”或更低,则在 Android 4.4 上运行时,现有同步请求将继续按照在先前版本上的方式运行。
打印框架
Android 现在包含一个完整的框架,允许用户使用通过 Wi-Fi、蓝牙或其他服务连接的打印机打印任何文档。系统会处理想要打印文档的应用与将打印作业交付给打印机的服务之间的事务。android.print 框架提供了指定打印文档并将其交付给系统进行打印所需的所有 API。对于给定的打印作业,您实际需要哪些 API 取决于您的内容。
打印常规内容
如果您想将界面中的内容打印为文档,则需要先创建 PrintDocumentAdapter 的子类。在此类中,您必须实现一些回调方法,包括 onLayout()(用于根据提供的打印属性建立布局)和 onWrite()(用于将可打印内容序列化为 ParcelFileDescriptor)。
如需将内容写入 ParcelFileDescriptor,您必须向其传递 PDF。新的 PdfDocument API 提供了一种便捷的方法,可从 getCanvas() 提供 Canvas,您可以在其中绘制可打印的内容。然后,使用 writeTo() 方法将 PdfDocument 写入 ParcelFileDescriptor。
为 PrintDocumentAdapter 定义实现后,您可以使用 PrintManager 方法 print() 根据用户请求执行打印作业,该方法将 PrintDocumentAdapter 作为其参数之一。
打印图片
如果您只想打印照片或其他位图,支持库中的辅助 API 会为您完成所有工作。只需创建 PrintHelper 的新实例,使用 setScaleMode() 设置缩放模式,然后将 Bitmap 传递给 printBitmap() 即可。大功告成。该库会处理与系统的所有剩余交互,以便将位图传送到打印机。
大楼打印服务
作为打印机 OEM,您可以使用 android.printservice 框架,让 Android 设备能够与您的打印机进行互操作。您可以将打印服务构建和分发为 APK,以便用户在设备上安装。打印服务应用主要通过对 PrintService 类进行子类化来作为无头服务运行,该类会从系统接收打印作业,并使用适当的协议将作业传达给其打印机。
如需详细了解如何打印应用内容,请参阅打印内容。
短信提供商
Telephony 内容提供程序(“短信提供程序”)允许应用在设备上读取和写入短信和彩信。其中包含已接收、已起草、已发送、待处理等短信和彩信的表格。
从 Android 4.4 开始,系统设置允许用户选择“默认短信应用”。选定后,只有默认短信应用能够向短信提供程序写入数据,并且只有默认短信应用会在用户收到短信时收到 SMS_DELIVER_ACTION 广播,或在用户收到彩信时收到 WAP_PUSH_DELIVER_ACTION 广播。默认短信应用负责在收到或发送新消息时将详细信息写入短信提供程序。
未被选为默认短信应用的其他应用只能读取短信提供程序,但也可以通过监听 SMS_RECEIVED_ACTION 广播(这是一种不可中止的广播,可能会传递给多个应用)在收到新短信时收到通知。此广播适用于需要读取特殊收到的消息(例如执行电话号码验证)的应用,即使这些应用未被选为默认短信应用。
如需了解详情,请参阅博文让您的短信应用做好准备,迎接 KitKat。
无线和连接
主机卡模拟
Android 应用现在可以模拟使用 APDU 进行数据交换的 ISO14443-4 (ISO-DEP) NFC 卡(如 ISO7816-4 中所指定)。这样一来,运行 Android 4.4 且支持 NFC 的设备便可同时模拟多张 NFC 卡,而 NFC 支付终端或其他 NFC 读取器则可根据应用标识符 (AID) 与相应的 NFC 卡发起交易。
如果您想在应用中模拟使用这些协议的 NFC 卡,请基于 HostApduService 类创建服务组件。而如果您的应用使用安全元件进行卡片模拟,则需要基于 OffHostApduService 类创建服务,该服务不会直接参与交易,但对于注册应由安全元件处理的 AID 是必要的。
如需了解详情,请参阅 NFC 卡模拟指南。
NFC 读取器模式
新的 NFC 读取器模式允许 activity 在前台运行时,将所有 NFC activity 限制为仅读取该 activity 感兴趣的标签类型。您可以使用 enableReaderMode() 为 activity 启用读取器模式,从而提供 NfcAdapter.ReaderCallback 的实现,以便在检测到新标签时接收回调。
这项新功能与主机卡模拟相结合,使 Android 能够在移动支付接口的两端运行:一台设备充当支付终端(运行读取器模式 activity 的设备),另一台设备充当支付客户端(模拟 NFC 卡的设备)。
红外发射器
在包含红外 (IR) 发射器的设备上运行时,您现在可以使用 ConsumerIrManager API 发射红外信号。如需获取 ConsumerIrManager 的实例,请调用 getSystemService(),并使用 CONSUMER_IR_SERVICE 作为实参。然后,您可以使用 getCarrierFrequencies() 查询设备支持的红外频率,并通过 transmit() 传递所需的频率和信号模式来传输信号。
您应始终先通过调用 hasIrEmitter() 来检查设备是否包含红外发射器,但如果您的应用仅与包含红外发射器的设备兼容,则应在清单中为 "android.hardware.consumerir" (FEATURE_CONSUMER_IR) 添加 <uses-feature> 元素。
多媒体
自适应播放
现在,MediaCodec API 支持自适应视频播放,从而可在播放到 Surface 期间无缝更改分辨率 - 您可以向解码器提供新分辨率的输入帧,输出缓冲区的分辨率会发生变化,而不会出现明显的间隙。
您可以通过向 MediaFormat 添加两个键来启用自适应播放,这两个键用于指定应用要求编解码器达到的最大分辨率:KEY_MAX_WIDTH 和 KEY_MAX_HEIGHT。将这些内容添加到 MediaFormat 后,使用 configure() 将 MediaFormat 传递给 MediaCodec 实例。
编解码器将以无缝方式在等于或小于这些值的分辨率之间转换。编解码器可能还支持高于指定最大分辨率的分辨率(只要在支持的配置文件的限制范围内),但过渡到更高分辨率可能无法无缝进行。
如需在解码 H.264 视频时更改分辨率,请继续使用 MediaCodec.queueInputBuffer() 将帧加入队列,但请务必在单个缓冲区中同时提供新的序列参数集 (SPS) 和图片参数集 (PPS) 值以及即时解码器刷新 (IDR) 帧。
不过,在尝试为自适应播放配置编解码器之前,您必须通过使用 FEATURE_AdaptivePlayback 调用 isFeatureSupported(String) 来验证设备是否支持自适应播放。
注意:对自适应播放的支持因供应商而异。对于较大的分辨率提示,某些编解码器可能需要更多内存。因此,您应根据要解码的素材设置分辨率上限。
点播音频时间戳
为了便于实现音视频同步,新的 AudioTimestamp 类提供了有关 AudioTrack 处理的音频串流中特定“帧”的时间轴详细信息。如需获取可用的最新时间戳,请实例化 AudioTimestamp 对象并将其传递给 getTimestamp()。如果时间戳请求成功,系统会使用帧单位的位置以及该帧呈现或承诺呈现的估计时间来填充 AudioTrack 实例。
您可以使用 AudioTimestamp 中的 nanoTime 值(单调)来查找与 framePosition 相比最接近的相关视频帧,以便丢弃、复制或插值视频帧来匹配音频。或者,您可以确定 nanoTime 的值与未来视频帧的预期时间之间的时间差(考虑采样率),以预测哪个音频帧与视频帧在同一时刻出现。
表面图像读取器
借助新的 ImageReader API,您可以直接访问渲染到 Surface 中的图片缓冲区。您可以使用静态方法 newInstance() 获取 ImageReader。然后,调用 getSurface() 以创建新的 Surface,并使用 MediaPlayer 或 MediaCodec 等提供方提供图片数据。如需在 Surface 提供新图片时收到通知,请实现 ImageReader.OnImageAvailableListener 接口并将其注册到 setOnImageAvailableListener()。
现在,当您将内容绘制到 Surface 时,每当有新的图片帧可用,您的 ImageReader.OnImageAvailableListener 就会收到对 onImageAvailable() 的调用,从而为您提供相应的 ImageReader。您可以使用 ImageReader,通过调用 acquireLatestImage() 或 acquireNextImage() 将帧的图片数据作为 Image 对象获取。
Image 对象可让您直接访问 ByteBuffer 中图片的时间戳、格式、尺寸和像素数据。不过,为了让 Image 类能够解读您的图片,这些图片必须采用 ImageFormat 或 PixelFormat 中的常量所定义的某种类型。
峰值和 RMS 测量
现在,您可以通过创建 Visualizer.MeasurementPeakRms 的新实例并将其传递给 getMeasurementPeakRms(),从 Visualizer 查询当前音频串流的峰值和 RMS。调用此方法时,给定 Visualizer.MeasurementPeakRms 的峰值和 RMS 值会设置为最新测量值。
响度增强器
LoudnessEnhancer 是 AudioEffect 的新子类,可让您提高 MediaPlayer 或 AudioTrack 的可听音量。这在与前面提到的新 getMeasurementPeakRms() 方法结合使用时尤其有用,以便在当前播放其他媒体时提高语音音轨的音量。
遥控器
Android 4.0(API 级别 14)引入了 RemoteControlClient API,可让媒体应用使用来自远程客户端(例如锁屏上的媒体控件)的媒体控制器事件。现在,借助新的 RemoteController API,您可以构建自己的遥控器,从而创建创新的新应用和外围设备,以便控制与 RemoteControlClient 集成的任何媒体应用的播放。
如需构建遥控器,您可以采用任何所需方式实现界面,但为了将媒体按钮事件传递给用户的媒体应用,您必须创建一个扩展 NotificationListenerService 类并实现 RemoteController.OnClientUpdateListener 接口的服务。以 NotificationListenerService 为基础非常重要,因为它提供了适当的隐私限制,要求用户在系统安全设置中将您的应用启用为通知监听器。
NotificationListenerService 类包含一些您必须实现的抽象方法,但如果您只关心用于处理媒体播放的媒体控制器事件,则可以将这些方法的实现留空,而专注于 RemoteController.OnClientUpdateListener 方法。
遥控器评分
Android 4.4 在远程控制客户端(通过 RemoteControlClient 接收媒体控制事件的应用)的现有功能基础上,新增了让用户能够通过远程控制器对当前曲目进行评分的功能。
新的 Rating 类封装了有关房客评分的信息。分级由其分级样式(RATING_HEART、RATING_THUMB_UP_DOWN、RATING_3_STARS、RATING_4_STARS、RATING_5_STARS 或 RATING_PERCENTAGE)和适合该样式的分级值定义。
如需允许用户通过遥控器对您的曲目进行评分,请执行以下操作:
- 通过在
setTransportControlFlags()中添加FLAG_KEY_MEDIA_RATING标志,表明您希望向用户显示评分界面(如果适用)。 - 调用
editMetadata()以检索RemoteControlClient.MetadataEditor,并将其与addEditableKey()一起传递给RATING_KEY_BY_USER。 - 然后,通过调用
putObject()并向其传递RATING_KEY_BY_USER作为键以及上述评分样式之一作为值来指定评分样式。
如需在用户通过遥控器更改评分时收到回调,请实现新的 RemoteControlClient.OnMetadataUpdateListener 接口,并将实例传递给 setMetadataUpdateListener()。当用户更改评分时,您的 RemoteControlClient.OnMetadataUpdateListener 会收到对 onMetadataUpdate() 的调用,其中 RATING_KEY_BY_USER 作为键,Rating 对象作为值。
字幕
VideoView 现在支持在播放 HTTP Live Streaming (HLS) 视频时使用 WebVTT 字幕轨道,并根据用户在系统设置中定义的字幕偏好设置显示字幕轨道。
您还可以使用 addSubtitleSource() 方法为 VideoView 提供 WebVTT 字幕轨道。此方法接受一个携带字幕数据的 InputStream 和一个指定字幕数据格式的 MediaFormat 对象,您可以使用 createSubtitleFormat() 指定该格式。这些字幕也会根据用户的偏好设置显示在视频上。
如果您不使用 VideoView 显示视频内容,则应使字幕叠加层尽可能符合用户的字幕偏好设置。借助新的 CaptioningManager API,您可以查询用户的字幕偏好设置,包括 CaptioningManager.CaptionStyle 定义的样式(例如字体和颜色)。如果用户在视频开始播放后调整了某些偏好设置,您应通过注册 CaptioningManager.CaptioningChangeListener 实例来监听偏好设置的变化,以便在任何偏好设置发生变化时接收回调,然后根据需要更新字幕。
动画和图形
场景和转场
新的 android.transition 框架提供了可在界面的不同状态之间实现动画效果的 API。一个关键功能是,您可以通过为每个状态创建单独的布局,来定义界面的不同状态(称为“场景”)。当您想要从一个场景过渡到另一个场景时,请执行“过渡”,这会计算必要的动画,以将布局从当前场景更改为下一个场景。
如需在两个场景之间进行过渡,您通常需要执行以下操作:
- 指定包含要更改的界面组件的
ViewGroup。 - 指定表示更改最终结果(下一个场景)的布局。
- 指定应为布局更改添加动画效果的过渡类型。
- 执行转换。
您可以使用 Scene 对象来完成第 1 步和第 2 步。Scene 包含描述执行过渡所需的布局属性的元数据,包括场景的父视图和场景的布局。您可以使用类构造函数或静态方法 getSceneForLayout() 创建 Scene。
然后,您必须使用 TransitionManager 完成第 3 步和第 4 步。一种方法是将 Scene 传递给静态方法 go()。这会在当前布局中找到场景的父视图,并对子视图执行过渡,以达到 Scene 定义的布局。
或者,您根本不需要创建 Scene 对象,而是可以调用 beginDelayedTransition(),并指定包含要更改的视图的 ViewGroup。然后,添加、移除或重新配置目标数据视图。系统根据需要对更改进行布局后,过渡会开始为所有受影响的视图添加动画效果。
如需进行更多控制,您可以使用项目 res/transition/ 目录中的 XML 文件定义应在预定义场景之间发生的过渡集。在 <transitionManager> 元素内,指定一个或多个 <transition> 标记,每个标记分别指定一个场景(对布局文件的引用)以及进入和/或退出该场景时要应用的过渡。然后,使用 inflateTransitionManager() 膨胀这组过渡。使用返回的 TransitionManager 通过 transitionTo() 执行每个转换,并传递由其中一个 <transition> 标记表示的 Scene。您还可以使用 TransitionManager API 以编程方式定义一组组转换。
指定过渡时,您可以使用由 Transition 的子类(例如 Fade 和 ChangeBounds)定义的几种预定义类型。如果您未指定过渡类型,系统会默认使用 AutoTransition,它会根据需要自动淡化、移动视图以及调整视图大小。此外,您还可以通过扩展这些类来创建自定义过渡,从而以您喜欢的方式执行动画。自定义过渡可以跟踪您想要的任何属性更改,并根据这些更改创建您想要的任何动画。例如,您可以提供一个 Transition 子类,用于监听视图的“rotation”属性的变化,然后为任何变化添加动画效果。
如需了解详情,请参阅 TransitionManager 文档。
Animator 暂停
现在,Animator API 允许您使用 pause() 和 resume() 方法暂停和恢复正在播放的动画。
如需跟踪动画的状态,您可以实现 Animator.AnimatorPauseListener 接口,该接口会在动画暂停和恢复时提供回调:pause() 和 resume()。然后,使用 addPauseListener() 将监听器添加到 Animator 对象。
或者,您也可以将 AnimatorListenerAdapter 抽象类子类化,该类现在包含 Animator.AnimatorPauseListener 定义的暂停和恢复回调的空实现。
可重复使用的位图
现在,您可以重复使用 BitmapFactory 中的任何可变位图来解码任何其他位图,即使新位图的大小不同,只要解码后的位图产生的字节数(可通过 getByteCount() 获取)小于或等于重复使用的位图的分配字节数(可通过 getAllocationByteCount() 获取)即可。如需了解详情,请参阅 inBitmap。
Bitmap 的新 API 允许进行类似的重新配置,以便在 BitmapFactory 之外重复使用(用于手动生成位图或自定义解码逻辑)。现在,您可以使用 setHeight() 和 setWidth() 方法设置位图的尺寸,并使用 setConfig() 指定新的 Bitmap.Config,而不会影响底层位图分配。reconfigure() 方法还提供了一种便捷的方法,只需一次调用即可合并这些更改。
不过,您不应重新配置视图系统当前使用的位图,因为底层像素缓冲区不会以可预测的方式重新映射。
用户内容
存储访问框架
在较低版本的 Android 系统中,如果您希望应用从其他应用检索特定类型的文件,则必须调用具有 ACTION_GET_CONTENT 操作的 intent。此操作仍然是请求您要导入到应用中的文件的适当方式。不过,Android 4.4 引入了 ACTION_OPEN_DOCUMENT 操作,该操作允许用户选择特定类型的文件,并授予应用对该文件的长期读取权限(可能具有写入权限),而无需将该文件导入到应用中。
如果您正在开发一款为文件提供存储服务的应用(例如云端存档服务),则可以通过将 content provider 实现为新 DocumentsProvider 类的子类,参与到这个统一的文件选取界面中。DocumentsProvider 的子类必须包含一个接受 PROVIDER_INTERFACE 操作 ("android.content.action.DOCUMENTS_PROVIDER") 的 intent 过滤器。然后,您必须在 DocumentsProvider 中实现以下四个抽象方法:
queryRoots()- 此方法必须返回一个
Cursor,该游标使用DocumentsContract.Root中定义的列来描述文档存储空间的所有根目录。 queryChildDocuments()- 此方法必须返回一个
Cursor,其中使用DocumentsContract.Document中定义的列来描述指定目录中的所有文件。 queryDocument()- 此方法必须返回一个
Cursor,该使用DocumentsContract.Document中定义的列来描述指定的文件。 openDocument()- 此方法必须返回一个表示指定文件的
ParcelFileDescriptor。用户选择文件且客户端应用通过调用openFileDescriptor()请求访问该文件后,系统会调用此方法。
如需了解详情,请参阅存储访问框架指南。
外部存储空间访问权限
现在,您可以在辅助外部存储介质上读取和写入应用专属文件,例如当设备同时提供模拟存储空间和 SD 卡时。新方法 getExternalFilesDirs() 的工作方式与现有 getExternalFilesDir() 方法相同,但它会返回一个 File 对象数组。在读取或写入此方法返回的任何路径之前,请将 File 对象传递给新的 getStorageState() 方法,以验证存储空间当前是否可用。
用于访问应用专用缓存目录和 OBB 目录的其他方法现在也有相应的版本,可提供对辅助存储设备的访问权限:分别为 getExternalCacheDirs() 和 getObbDirs()。
返回的 File 数组中的第一个条目被视为设备的主外部存储空间,这与现有方法(例如 getExternalFilesDir())返回的 File 相同。
注意:从 Android 4.4 开始,如果您只需要使用上述方法访问外部存储空间中应用专属的区域,则平台不再要求您的应用获取 WRITE_EXTERNAL_STORAGE 或 READ_EXTERNAL_STORAGE。不过,如果您想访问由 getExternalStoragePublicDirectory() 提供的外部存储空间的可共享区域,则需要这些权限。
同步适配器
ContentResolver 中的新 requestSync() 方法通过将请求封装在新的 SyncRequest 对象(您可以使用 SyncRequest.Builder 创建)中,简化了为 ContentProvider 定义同步请求的部分过程。SyncRequest 中的属性提供与现有 ContentProvider 同步调用相同的功能,但增加了通过启用 setDisallowMetered() 来指定在网络按流量计费时应放弃同步的功能。
用户输入
新传感器类型
新的 TYPE_GEOMAGNETIC_ROTATION_VECTOR 传感器基于磁力计提供旋转矢量数据,当陀螺仪不可用时,或者与批处理传感器事件结合使用以在手机休眠时记录设备方向时,该传感器是 TYPE_ROTATION_VECTOR 传感器的实用替代方案。此传感器所需的电量低于 TYPE_ROTATION_VECTOR,但可能容易产生嘈杂的事件数据,并且在用户处于户外时最有效。
Android 现在还支持硬件中的内置步数传感器:
TYPE_STEP_DETECTOR- 每当用户迈出一步,此传感器就会触发一个事件。用户每走一步,此传感器就会传送一个值为 1.0 的事件,并附带一个指示该步发生时间的时间戳。
TYPE_STEP_COUNTER- 此传感器也会在每次检测到步数时触发事件,但会提供自应用首次注册此传感器以来累计的总步数。
请注意,这两个步测传感器并不总是提供相同的结果。TYPE_STEP_COUNTER 事件的延迟时间比 TYPE_STEP_DETECTOR 事件长,但这是因为 TYPE_STEP_COUNTER 算法会执行更多处理来消除假正例。因此,TYPE_STEP_COUNTER 传送事件的速度可能会较慢,但其结果应该更准确。
这两种步测传感器都依赖于硬件(Nexus 5 是首款支持它们的设备),因此您应使用 FEATURE_SENSOR_STEP_DETECTOR 和 FEATURE_SENSOR_STEP_COUNTER 常量通过 hasSystemFeature() 检查可用性。
批处理传感器事件
为了更好地管理设备电量,SensorManager API 现在允许您指定希望系统向应用批量传送传感器事件的频率。这不会减少在给定时间段内应用可用的实际传感器事件数量,而是会降低系统通过传感器更新调用 SensorEventListener 的频率。也就是说,系统不会在每个事件发生时立即将其传递给您的应用,而是会保存一段时间内发生的所有事件,然后一次性将它们全部传递给您的应用。
为了提供批处理功能,SensorManager 类添加了两个新版本的 registerListener() 方法,可让您指定“最大报告延迟时间”。这个新参数指定了 SensorEventListener 在传送新传感器事件时可容忍的最大延迟时间。例如,如果您指定批处理延迟时间为 1 分钟,系统将以不超过 1 分钟的间隔,通过连续调用 onSensorChanged() 方法(针对每个已批处理的事件调用一次)来传送最近的一组批处理事件。传感器事件的延迟时间绝不会超过最大报告延迟时间值,但如果其他应用针对同一传感器请求了更短的延迟时间,则传感器事件可能会更早到达。
不过,请注意,传感器仅在 CPU 处于唤醒状态时,才会根据您的报告延迟时间向您的应用传送批处理事件。虽然支持批处理的硬件传感器会在 CPU 处于休眠状态时继续收集传感器事件,但它不会唤醒 CPU 来向您的应用传送批处理事件。当传感器的事件内存最终耗尽时,它将开始丢弃最旧的事件,以保存最新的事件。您可以在传感器填满其内存之前唤醒设备,然后调用 flush() 来捕获最新一批事件,从而避免丢失事件。如需估算内存何时会满以及何时应刷新,请调用 getFifoMaxEventCount() 以获取内存可保存的最大传感器事件数,然后将该数字除以应用需要每个事件的速率。使用该计算结果通过 AlarmManager 设置唤醒闹钟,以调用 Service(实现 SensorEventListener)来刷新传感器。
注意:并非所有设备都支持批处理传感器事件,因为这需要硬件传感器的支持。不过,从 Android 4.4 开始,您应始终使用新的 registerListener() 方法,因为如果设备不支持批处理,系统会忽略批处理延迟参数,并实时传递传感器事件。
控制器身份
Android 现在会使用一个唯一的整数来标识每个已连接的控制器,您可以使用 getControllerNumber() 查询该整数,从而更轻松地将每个控制器与游戏中的不同玩家相关联。每个控制器的编号可能会因控制器断开连接、连接或由用户重新配置而发生变化,因此您应通过注册 InputManager.InputDeviceListener 的实例来跟踪哪个控制器编号对应于哪个输入设备。然后,在发生更改时为每个 InputDevice 调用 getControllerNumber()。
已连接的设备现在还会提供可从 getProductId() 和 getVendorId() 获取的产品 ID 和供应商 ID。如果您需要根据设备上的可用按键集修改按键映射,可以查询设备,以检查某些按键是否可通过 hasKeys(int...) 使用。
界面
沉浸式全屏模式
为了让您的应用采用填充整个屏幕的布局,setSystemUiVisibility() 的新 SYSTEM_UI_FLAG_IMMERSIVE 标志(与 SYSTEM_UI_FLAG_HIDE_NAVIGATION 结合使用时)可启用新的沉浸式全屏模式。启用沉浸式全屏模式后,您的 activity 会继续接收所有触摸事件。用户可以沿着系统栏通常出现的区域向内滑动,以显示系统栏。这会清除 SYSTEM_UI_FLAG_HIDE_NAVIGATION 标志(以及 SYSTEM_UI_FLAG_FULLSCREEN 标志,如果已应用),以便系统栏保持可见。不过,如果您希望系统栏在片刻后再次隐藏,则可以改用 SYSTEM_UI_FLAG_IMMERSIVE_STICKY 标志。
半透明系统栏
现在,您可以使用新主题 Theme.Holo.NoActionBar.TranslucentDecor 和 Theme.Holo.Light.NoActionBar.TranslucentDecor 让系统栏部分透明。启用半透明系统栏后,您的布局将填充系统栏后面的区域,因此您还必须为不应被系统栏覆盖的布局部分启用 fitsSystemWindows。
如果您要创建自定义主题,请将其中一个主题设置为父主题,或在主题中添加 windowTranslucentNavigation 和 windowTranslucentStatus 样式属性。
增强型通知监听器
Android 4.3 添加了 NotificationListenerService API,允许应用接收有关系统发布的新通知的信息。在 Android 4.4 中,通知监听器可以检索通知的其他元数据以及有关通知操作的完整详细信息:
新的 Notification.extras 字段包含一个 Bundle,用于向通知构建器提供其他元数据,例如 EXTRA_TITLE 和 EXTRA_PICTURE。
新的 Notification.Action 类定义了附加到通知的操作的特征,您可以从新的 actions 字段中检索这些特征。
针对 RTL 布局的可绘制对象镜像
在旧版 Android 上,如果您的应用包含应针对从右到左布局反转其水平方向的图片,您必须在 drawables-ldrtl/ 资源目录中添加镜像图片。现在,系统可以通过在可绘制资源上启用 autoMirrored 属性或通过调用 setAutoMirrored() 来自动为您镜像图片。启用后,当布局方向为从右到左时,Drawable 会自动镜像。
无障碍
现在,通过向 XML 布局添加新的 accessibilityLiveRegion 属性或调用 setAccessibilityLiveRegion(),View 类可让您为界面中动态更新新文本内容的部分声明“动态区域”。例如,如果登录屏幕中有一个显示“密码不正确”通知的文本字段,则应将该字段标记为动态区域,以便屏幕阅读器在消息发生变化时朗读该消息。
提供无障碍服务的应用现在还可以通过新的 API 增强其功能,这些 API 使用 AccessibilityNodeInfo.CollectionInfo 和 AccessibilityNodeInfo.CollectionItemInfo 提供有关视图集合(例如列表视图或网格视图)的信息。
应用权限
以下是您的应用必须使用 <uses-permission> 标记请求的新权限,以便使用某些新 API:
INSTALL_SHORTCUT- 允许应用在启动器中安装快捷方式
UNINSTALL_SHORTCUT- 允许应用在启动器中卸载快捷方式
TRANSMIT_IR- 允许应用使用设备的红外发射器(如果有)
注意:从 Android 4.4 开始,当您想使用 getExternalFilesDir() 等方法访问外部存储空间的应用专属区域时,平台不再要求您的应用获取 WRITE_EXTERNAL_STORAGE 或 READ_EXTERNAL_STORAGE。不过,如果您想访问由 getExternalStoragePublicDirectory() 提供的外部存储空间的可共享区域,则仍需这些权限。
设备功能
以下是您可以使用 <uses-feature> 标记声明的新设备功能,用于声明应用要求并在 Google Play 上启用过滤功能或在运行时进行检查:
FEATURE_CONSUMER_IR- 设备能够与消费 IR 设备进行通信。
FEATURE_DEVICE_ADMIN- 设备支持使用设备管理员强制执行设备政策。
FEATURE_NFC_HOST_CARD_EMULATION- 设备支持基于主机的 NFC 卡模拟。
FEATURE_SENSOR_STEP_COUNTER- 设备包含硬件计步器。
FEATURE_SENSOR_STEP_DETECTOR- 设备包含硬件步测器。
如需详细了解 Android 4.4 中的所有 API 变更,请参阅 API 差异报告。