API 级别:14
Android 4.0 (ICE_CREAM_SANDWICH) 是一个重要的平台版本,为用户和应用开发者添加了各种新功能。除了下文讨论的所有新功能和 API 之外,Android 4.0 还是一个重要的平台版本,因为它将 Android 3.x 中的大量 API 和全息主题引入了较小的屏幕。作为应用开发者,您现在拥有一个统一的平台和统一的 API 框架,让您能够开发和发布单个 APK,为搭载相同 Android 版本(Android 4.0 [API 级别 14] 或更高版本)的手机、平板电脑等设备提供优化的用户体验。
对于开发者,Android 4.0 平台可作为 Android SDK 的可下载组件。可下载的平台包括 Android 库和系统映像,以及一组模拟器皮肤等。如需开始针对 Android 4.0 进行开发或测试,请使用 Android SDK 管理器将该平台下载到您的 SDK 中。
API 概览
以下部分从技术角度简要介绍了 Android 4.0 中的新 API。
联系人提供程序中的社交 API
由 ContactsContract 提供程序定义的联系人 API 已扩展,以支持新的社交功能,例如设备所有者的个人资料,以及用户邀请个人联系人加入设备上安装的社交网络的功能。
用户个人资料
Android 现在包含一个代表设备所有者的个人资料,如 ContactsContract.Profile 表中所定义。维护用户身份的社交应用可以通过在 ContactsContract.Profile 中创建新的 ContactsContract.RawContacts 条目,为用户的个人资料数据做出贡献。也就是说,代表设备用户的原始联系人不属于由 ContactsContract.RawContacts URI 定义的传统原始联系人表;您必须在 CONTENT_RAW_CONTACTS_URI 处的表中添加个人资料原始联系人。然后,此表中的原始联系人会汇总到标记为“我”的单个用户可见个人资料中。
如需为个人资料添加新的原始联系人,需要具备 android.Manifest.permission#WRITE_PROFILE 权限。同样,为了从个人资料表中读取数据,您必须请求 android.Manifest.permission#READ_PROFILE 权限。不过,大多数应用都不需要读取用户个人资料,即使在向个人资料提供数据时也是如此。读取用户个人资料是一项敏感权限,用户可能会对请求此权限的应用持怀疑态度。
邀请意图
INVITE_CONTACT intent 操作允许应用调用一项操作,该操作表明用户希望将联系人添加到社交网络。接收该 intent 的应用会使用它来邀请指定联系人加入该社交网络。大多数应用都将是此操作的接收端。例如,当用户为某人的详细联系信息中列出的特定社交应用选择“添加联系人”时,内置的“人脉”应用会调用邀请 intent。
如需让您的应用显示在“添加连接”列表中,您的应用必须提供一个同步适配器,用于同步社交网络中的联系信息。然后,您必须向系统指明您的应用会响应 INVITE_CONTACT intent,方法是将 inviteContactActivity 属性添加到应用的同步配置文件中,并提供系统在发送邀请 intent 时应启动的 activity 的完全限定名称。然后,启动的 activity 可以从 intent 的数据中检索相关联系人的 URI,并执行必要的工作,以邀请该联系人加入网络或将该联系人添加到用户的连接中。
大照片
Android 现在支持为联系人设置高分辨率照片。现在,当您将照片推送到联系人记录中时,系统会将其处理成 96x96 的缩略图(与之前一样)和 256x256 的“显示照片”,后者存储在新的基于文件的照片存储区中(系统选择的确切尺寸将来可能会有所不同)。您可以通过将大照片放入数据行的常规 PHOTO 列中,为联系人添加大照片,然后系统会将其处理为适当的缩略图并显示照片记录。
联系人使用情况反馈
借助新的 ContactsContract.DataUsageFeedback API,您可以跟踪用户使用特定联系方式的频率,例如用户使用每个电话号码或邮箱的频率。这些信息有助于改进与每个人关联的每种联系方式的排名,并提供更好的联系建议。
日历提供程序
借助新的日历 API,您可以读取、添加、修改和删除存储在日历提供程序中的日历、活动、参加者、提醒和提醒。
各种应用和微件都可以使用这些 API 来读取和修改日历活动。不过,最引人注目的用例是一些同步适配器,它们可将用户来自其他日历服务的日历与日历提供程序同步,以便为用户的所有活动提供一个统一的位置。例如,Google 日历活动由 Google 日历同步适配器与日历提供程序同步,从而允许使用 Android 的内置日历应用查看这些活动。
日历提供程序中的日历和活动相关信息的数据模型由 CalendarContract 定义。用户的所有日历数据都存储在由 CalendarContract 的各种子类定义的多个表中:
CalendarContract.Calendars表包含特定于日历的信息。此表中的每一行都包含单个日历的详细信息,例如名称、颜色和同步信息。CalendarContract.Events表包含特定于事件的信息。此表中的每一行都包含单个活动的信息,例如活动标题、地点、开始时间和结束时间。该事件可以发生一次,也可以重复发生多次。参加者、提醒和扩展属性存储在单独的表中,并使用活动的_ID将它们与活动关联。CalendarContract.Instances表包含事件发生的开始时间和结束时间。此表中的每一行都代表一个发生实例。对于一次性活动,实例与活动之间存在一对一映射。对于周期性活动,系统会自动生成多行,以对应于该活动的多次发生。CalendarContract.Attendees表包含活动参加者或邀请对象信息。每一行代表活动的一位邀请对象。它指定了该人员的邀请对象类型以及该人员对活动的回复。CalendarContract.Reminders表用于存储提醒/通知数据。 每一行代表一个事件的单个提醒。一个活动可以有多个提醒。每个活动的提醒数量在MAX_REMINDERS中指定,由拥有给定日历的同步适配器设置。提醒以活动预定时间之前的分钟数指定,并指定提醒方法,例如使用提醒、电子邮件或短信来提醒用户。CalendarContract.ExtendedProperties表包含同步适配器使用的不透明数据字段。提供程序不会对此表中的项执行任何操作,除非在删除相关事件时删除这些项。
如需使用日历提供程序访问用户的日历数据,您的应用必须请求 READ_CALENDAR 权限(用于读取访问权限)和 WRITE_CALENDAR(用于写入访问权限)。
事件 intent
如果您只想向用户的日历添加活动,可以使用 ACTION_INSERT intent 以及由 Events.CONTENT_URI 定义的数据,以便在日历应用中启动创建新活动的 activity。使用该 intent 不需要任何权限,您可以使用以下 extra 指定活动详情:
Events.TITLE:事件的名称CalendarContract.EXTRA_EVENT_BEGIN_TIME:事件开始时间(以自公元纪年开始的毫秒数表示)CalendarContract.EXTRA_EVENT_END_TIME:事件结束时间(以从公元纪年开始计算的毫秒数表示)Events.EVENT_LOCATION:活动地点Events.DESCRIPTION:活动说明Intent.EXTRA_EMAIL:受邀者的邮箱Events.RRULE:活动的重复规则Events.ACCESS_LEVEL:活动是私密还是公开Events.AVAILABILITY:此活动的时间段是否允许同时安排其他活动
语音信箱服务提供商
借助新的语音信箱提供程序,应用可以向设备添加语音信息,以便在单个可视化演示中呈现用户的所有语音信息。例如,用户可能有多个语音信息来源,例如一个来自手机的服务提供商,其他来自 VoIP 或其他替代语音服务。这些应用可以使用语音信箱提供程序 API 将其语音信息添加到设备中。然后,内置的“电话”应用会以统一的形式向用户显示所有语音信息。 虽然系统的“电话”应用是唯一可以读取所有语音信息
由于这些 API 目前不允许第三方应用读取系统中的所有语音信息,因此只有需要向用户发送语音信息的第三方应用才应使用语音信息 API。
VoicemailContract 类为语音信箱提供程序定义了 content provider。子类 VoicemailContract.Voicemails 和 VoicemailContract.Status 提供了表,应用可以在其中插入语音信息数据,以便存储在设备上。如需查看语音信箱提供商应用的示例,请参阅语音信箱提供商演示。
多媒体
Android 4.0 为与媒体(例如照片、视频和音乐)互动的应用添加了多个新 API。
媒体效应
借助新的媒体效果框架,您可以对图片和视频应用各种视觉效果。例如,图片效果可让您消除红眼、将图片转换为灰度、调整亮度、调整饱和度、旋转图片、应用鱼眼效果等。系统会在 GPU 上执行所有效果处理,以获得最佳性能。
为了实现最佳性能,效果会直接应用于 OpenGL 纹理,因此您的应用必须具有有效的 OpenGL 上下文,然后才能使用效果 API。您应用效果的纹理可能来自位图、视频甚至相机。不过,纹理必须满足某些限制:
- 它们必须绑定到
GL_TEXTURE_2D纹理图片 - 它们必须至少包含一个 mipmap 级别
Effect 对象定义了您可以应用于图片帧的单个媒体效果。创建 Effect 的基本工作流如下:
- 从 OpenGL ES 2.0 上下文中调用
EffectContext.createWithCurrentGlContext()。 - 使用返回的
EffectContext调用EffectContext.getFactory(),后者会返回EffectFactory的实例。 - 调用
createEffect(),并向其传递 @link android.media.effect.EffectFactory} 中的效果名称,例如EFFECT_FISHEYE或EFFECT_VIGNETTE。
您可以通过调用 setParameter() 并传递参数名称和参数值来调整效果的参数。每种类型的效果都接受不同的参数,这些参数会与效果名称一起记录。例如,EFFECT_FISHEYE 有一个参数用于指定失真的 scale。
如需对纹理应用效果,请对 Effect 调用 apply(),并传入输入纹理、其宽度和高度以及输出纹理。输入纹理必须绑定到 GL_TEXTURE_2D 纹理图片(通常通过调用 glTexImage2D() 函数完成)。您可以提供多个 Mipmap 级别。如果输出纹理尚未绑定到纹理图片,则效果会自动将其绑定为 GL_TEXTURE_2D,并具有一个 mipmap 级别 (0),其大小与输入相同。
EffectFactory 中列出的所有效果都保证受支持。
不过,并非所有设备都支持外部库提供的某些额外效果,因此您必须先调用 isEffectSupported(),检查外部库中所需的效果是否受支持。
遥控客户端
借助新的 RemoteControlClient,媒体播放器可以启用来自远程控制客户端(例如设备锁定屏幕)的播放控件。媒体播放器还可以公开有关当前正在播放的媒体的信息,以便在遥控器上显示,例如曲目信息和专辑封面。
如需为媒体播放器启用远程控制客户端,请使用其构造函数实例化 RemoteControlClient,并向其传递广播 ACTION_MEDIA_BUTTON 的 PendingIntent。该 intent 还必须声明应用中用于处理 ACTION_MEDIA_BUTTON 事件的显式 BroadcastReceiver 组件。
如需声明播放器可以处理哪些媒体控制输入,您必须在 RemoteControlClient 上调用 setTransportControlFlags(),并传递一组 FLAG_KEY_MEDIA_* 标志,例如 FLAG_KEY_MEDIA_PREVIOUS 和 FLAG_KEY_MEDIA_NEXT。
然后,您必须将 传递给 MediaManager.registerRemoteControlClient(),以注册该 RemoteControlClient。
注册后,当用户按下遥控器上的按钮时,您在实例化 RemoteControlClient 时声明的广播接收器将收到 ACTION_MEDIA_BUTTON 事件。您收到的 intent 包含所按媒体键的 KeyEvent,您可以使用 getParcelableExtra(Intent.EXTRA_KEY_EVENT) 从 intent 中检索该值。
如需在遥控器上显示有关正在播放的媒体的信息,请调用 editMetaData() 并向返回的 RemoteControlClient.MetadataEditor 添加元数据。您可以提供媒体插图的位图、数字信息(例如经过的时间)和文本信息(例如曲目标题)。如需了解可用键,请参阅 MediaMetadataRetriever 中的 METADATA_KEY_* 标志。
如需查看示例实现,请参阅随机音乐播放器,该播放器提供了兼容性逻辑,使其能够在 Android 4.0 设备上启用远程控制客户端,同时继续支持 Android 2.1 及更高版本的设备。
媒体播放器
- 现在,从
MediaPlayer流式传输在线媒体需要INTERNET权限。如果您使用MediaPlayer播放来自互联网的内容,请务必将INTERNET权限添加到清单中,否则从 Android 4.0 开始,您的媒体播放将无法正常运行。 setSurface()允许您定义一个Surface作为视频接收器。setDataSource()允许您在请求中发送额外的 HTTP 标头,这对于 HTTP(S) 直播非常有用- HTTP(S) 直播现在会遵循跨请求的 HTTP Cookie
媒体类型
Android 4.0 增加了对以下内容的支持:
- HTTP/HTTPS 直播协议版本 3
- ADTS 原始 AAC 音频编码
- WEBP 图片
- Matroska 视频
如需了解详情,请参阅支持的媒体格式。
相机
Camera 类现在包含用于检测人脸以及控制焦点和测光区域的 API。
人脸检测
相机应用现在可以使用 Android 的人脸检测 API 增强其功能,这些 API 不仅可以检测拍摄对象的人脸,还可以检测特定的面部特征,例如眼睛和嘴巴。
如需在相机应用中检测人脸,您必须通过调用 setFaceDetectionListener() 来注册 Camera.FaceDetectionListener。然后,您可以通过调用 startFaceDetection() 启动相机 Surface 并开始检测人脸。
当系统在相机场景中检测到一个或多个面孔时,它会调用 Camera.FaceDetectionListener 实现中的 onFaceDetection() 回调,包括 Camera.Face 对象的数组。
Camera.Face 类的实例可提供有关检测到的人脸的各种信息,包括:
- 一个
Rect,用于指定相对于相机当前视野范围的面部边界 - 一个介于 1 到 100 之间的整数,表示系统对该对象是人脸的置信度
- 唯一 ID,以便您跟踪多张面孔
- 多个
Point对象,用于指示眼睛和嘴巴的位置
注意:某些设备可能不支持人脸检测,因此您应通过调用 getMaxNumDetectedFaces() 进行检查,并确保返回值大于零。此外,某些设备可能不支持识别眼睛和嘴巴,在这种情况下,Camera.Face 对象中的这些字段将为 null。
对焦和测光区域
相机应用现在可以控制相机用于对焦以及测定白平衡和自动曝光的区域。这两项功能都使用新的 Camera.Area 类来指定相机当前视图中应聚焦或测光的区域。Camera.Area 类的实例使用 Rect 定义区域的边界,并使用整数定义区域的权重(表示该区域相对于考虑的其他区域的重要性级别)。
在设置焦点区域或测光区域之前,您应先分别调用 getMaxNumFocusAreas() 或 getMaxNumMeteringAreas()。如果这些函数返回零,则表示设备不支持相应功能。
如需指定要使用的对焦或测光区域,只需调用 setFocusAreas() 或 setMeteringAreas() 即可。每个方法都接受一个 Camera.Area 对象的 List,这些对象表示要考虑对焦或测光的区域。例如,您可以实现一项功能,让用户通过轻触预览区域来设置焦点区域,然后您将该区域转换为 Camera.Area 对象,并请求相机聚焦于场景的该区域。该区域的焦点或曝光度会随着该区域场景的变化而不断更新。
拍照时连续自动对焦
现在,您可以在拍照时启用连续自动对焦 (CAF)。如需在相机应用中启用 CAF,请将 FOCUS_MODE_CONTINUOUS_PICTURE 传递给 setFocusMode()。准备好拍照后,调用 autoFocus()。您的 Camera.AutoFocusCallback 会立即收到一个回调,以指示是否已获得焦点。如需在收到回调后恢复 CAF,您必须调用 cancelAutoFocus()。
注意:使用 FOCUS_MODE_CONTINUOUS_VIDEO(在 API 级别 9 中添加)拍摄视频时,也支持连续自动对焦。
其他相机功能
- 现在,您可以在录制视频时调用
takePicture()来保存照片,而不会中断视频会话。在执行此操作之前,您应调用isVideoSnapshotSupported(),以确保硬件支持此操作。 - 您现在可以使用
setAutoExposureLock()和setAutoWhiteBalanceLock()锁定自动曝光和白平衡,以防止这些属性发生变化。 - 现在,您可以在相机预览运行时调用
setDisplayOrientation()。以前,您只能在开始预览之前调用此方法,但现在您可以随时更改屏幕方向。
相机广播 intent
Camera.ACTION_NEW_PICTURE:表示用户已拍摄新照片。内置相机应用会在拍摄照片后调用此广播,第三方相机应用也应在拍摄照片后广播此 intent。Camera.ACTION_NEW_VIDEO:这表示用户已拍摄新视频。内置相机应用会在录制视频后调用此广播,第三方相机应用也应在拍摄视频后广播此 intent。
Android Beam(通过 NFC 进行 NDEF 推送)
Android Beam 是一项新的 NFC 功能,可让您将 NDEF 消息从一台设备发送到另一台设备(此过程也称为“NDEF 推送”)。当两个支持 Android Beam 的 Android 设备靠近(约 4 厘米)时,通常是背面接触,就会启动数据传输。NDEF 消息中的数据可以包含您要在设备之间共享的任何数据。例如,“联系人”应用分享联系人,“YouTube”分享视频,“浏览器”使用 Android Beam 分享网址。
如需使用 Android Beam 在设备之间传输数据,您需要创建一个 NdefMessage,其中包含您要在 activity 处于前台时分享的信息。然后,您必须通过以下两种方式之一将 NdefMessage 传递给系统:
- 定义一个在 activity 中推送的
NdefMessage:随时致电
setNdefPushMessage(),设置您要发送的消息。例如,您可以在 activity 的onCreate()方法中调用此方法并向其传递NdefMessage。然后,只要在 activity 处于前台时通过另一台设备激活 Android Beam,系统就会将NdefMessage发送到另一台设备。 - 定义在 Android Beam 启动时要推送的
NdefMessage:实现
NfcAdapter.CreateNdefMessageCallback,其中createNdefMessage()方法的实现会返回您要发送的NdefMessage。然后,将NfcAdapter.CreateNdefMessageCallback实现传递给setNdefPushMessageCallback()。在这种情况下,当您的 activity 位于前台时,如果 Android Beam 与其他设备一起激活,系统会调用
createNdefMessage()来检索您要发送的NdefMessage。这样,您就可以定义NdefMessage,以便仅在 Android Beam 启动后才传送,以防消息内容在 activity 的整个生命周期内发生变化。
如果您希望在系统成功将 NDEF 消息传递到其他设备后运行某些特定代码,可以实现 NfcAdapter.OnNdefPushCompleteCallback 并使用 setNdefPushCompleteCallback() 进行设置。然后,系统会在消息传递时调用 onNdefPushComplete()。
在接收设备上,系统会以类似于常规 NFC 标签的方式分发 NDEF 推送消息。系统会调用具有 ACTION_NDEF_DISCOVERED 操作的 intent 来启动 activity,并根据 NdefMessage 中的第一个 NdefRecord 设置网址或 MIME 类型。对于您要响应的 activity,您可以为应用关注的网址或 MIME 类型声明 intent 过滤器。如需详细了解标签调度,请参阅 NFC 开发者指南。
如果您希望 NdefMessage 携带 URI,现在可以使用便捷方法 createUri,根据字符串或 Uri 对象构建新的 NdefRecord。如果 URI 采用特殊格式,并且您希望应用在 Android Beam 事件期间也接收该 URI,则应使用相同的 URI scheme 为 activity 创建 intent 过滤器,以便接收传入的 NDEF 消息。
您还应将“Android 应用记录”与 NdefMessage 一起传递,以确保您的应用能够处理传入的 NDEF 消息,即使其他应用会过滤相同的 intent 操作。您可以通过调用 createApplicationRecord() 并向其传递应用的软件包名称来创建 Android 应用记录。当另一台设备收到包含应用记录的 NDEF 消息,并且多个应用包含处理指定 intent 的 activity 时,系统始终会将该消息传递给您应用中的 activity(基于匹配的应用记录)。如果目标设备当前未安装您的应用,系统会使用 Android 应用记录启动 Google Play,并将用户引导至该应用,以便用户安装。
如果您的应用不使用 NFC API 来执行 NDEF 推送消息传递,则 Android 会提供默认行为:当您的应用在某台设备上处于前台,并且通过另一台搭载 Android 的设备调用 Android Beam 时,另一台设备会收到一条 NDEF 消息,其中包含用于标识您的应用的 Android 应用记录。如果接收设备已安装该应用,系统会启动该应用;如果未安装,Google Play 会打开并引导用户前往您的应用,以便用户安装该应用。
如需详细了解 Android Beam 和其他 NFC 功能,请参阅 NFC 基础知识开发者指南。如需查看使用 Android Beam 的一些示例代码,请参阅 Android Beam 演示。
Wi-Fi P2P
Android 现在支持在 Android 设备与其他设备类型之间建立 WLAN 直连 (P2P) 连接(符合 Wi-Fi 联盟的 Wi-Fi Direct™ 认证计划),而无需热点或互联网连接。Android 框架提供了一组 Wi-Fi P2P API,可让您在每台设备都支持 Wi-Fi P2P 时发现并连接到其他设备,然后通过快速连接进行通信,其通信距离比蓝牙连接长得多。
新软件包 android.net.wifi.p2p 包含用于通过 Wi-Fi 执行点对点连接的所有 API。您需要使用的主要类是 WifiP2pManager,您可以通过调用 getSystemService(WIFI_P2P_SERVICE) 来获取该类。WifiP2pManager 包含可让您执行以下操作的 API:
- 通过调用
initialize()为点对点连接初始化应用 - 通过调用
discoverPeers()发现附近的设备 - 通过调用
connect()启动 P2P 连接 - 等等
此外,还需要其他几个接口和类,例如:
- 借助
WifiP2pManager.ActionListener接口,您可以在发现对等设备或连接到对等设备等操作成功或失败时接收回调。 WifiP2pManager.PeerListListener接口可让您接收有关已发现的对等设备的信息。该回调会提供一个WifiP2pDeviceList,您可以从中检索范围内每个设备的WifiP2pDevice对象,并获取设备名称、地址、设备类型、设备支持的 WPS 配置等信息。WifiP2pManager.GroupInfoListener接口可让您接收有关 P2P 群组的信息。该回调会提供一个WifiP2pGroup对象,其中包含群组信息,例如所有者、网络名称和口令。WifiP2pManager.ConnectionInfoListener接口可让您接收有关当前连接的信息。回调会提供一个WifiP2pInfo对象,其中包含群组是否已形成以及群组所有者是谁等信息。
如需使用 Wi-Fi P2P API,您的应用必须请求以下用户权限:
ACCESS_WIFI_STATECHANGE_WIFI_STATEINTERNET(虽然您的应用在技术上并未连接到互联网,但使用标准 Java 套接字与 Wi-Fi 点对点对等设备进行通信需要互联网权限)。
Android 系统还会在发生某些 Wi-Fi P2P 事件时广播多个不同的操作:
WIFI_P2P_CONNECTION_CHANGED_ACTION:P2P 连接状态已更改。这会携带一个WifiP2pInfo对象的EXTRA_WIFI_P2P_INFO和一个NetworkInfo对象的EXTRA_NETWORK_INFO。WIFI_P2P_STATE_CHANGED_ACTION:点对点状态已在启用和停用之间切换。它携带EXTRA_WIFI_STATE,并带有WIFI_P2P_STATE_DISABLED或WIFI_P2P_STATE_ENABLEDWIFI_P2P_PEERS_CHANGED_ACTION:对等设备列表已更改。WIFI_P2P_THIS_DEVICE_CHANGED_ACTION:此设备的详细信息已更改。
如需了解详情,请参阅 WifiP2pManager 文档。另请参阅 Wi-Fi P2P 演示示例应用。
蓝牙健康设备
Android 现在支持蓝牙健康规范设备,因此您可以创建使用蓝牙与支持蓝牙的健康设备(例如心率监测仪、血糖仪、温度计和体重秤)进行通信的应用。
与常规耳机和 A2DP 配置文件设备类似,您必须使用 BluetoothProfile.ServiceListener 和 HEALTH 配置文件类型调用 getProfileProxy(),才能与配置文件代理对象建立连接。
获取健康配置文件代理(BluetoothHealth 对象)后,连接到配对的健康设备并与之通信会涉及以下新的蓝牙类:
BluetoothHealthCallback:您必须扩展此类并实现回调方法,才能接收有关应用注册状态和蓝牙通道状态变化的更新。BluetoothHealthAppConfiguration:在回调到BluetoothHealthCallback期间,您将收到此对象的实例,该实例提供有关可用蓝牙健康设备的配置信息,您必须使用这些信息来执行各种操作,例如使用BluetoothHealthAPI 发起和终止连接。
如需详细了解如何使用蓝牙健康配置文件,请参阅 BluetoothHealth 的文档。
无障碍
Android 4.0 改进了视障用户的无障碍功能,提供了全新的轻触探索模式和扩展 API,让您能够提供有关视图内容的更多信息或开发高级无障碍服务。
轻触探索模式
现在,视力受损的用户可以通过触摸屏幕并在屏幕上拖动手指来探索屏幕,从而听取内容的语音描述。由于轻触探索模式的工作方式类似于虚拟光标,因此它允许屏幕阅读器以与用户使用方向键或轨迹球进行导航时相同的方式识别描述性文本,即在模拟“悬停”事件时读取 android:contentDescription 和 setContentDescription() 提供的信息。因此,请将此视为一个提醒,您应该为应用中的视图提供描述性文本,尤其是 ImageButton、EditText、ImageView 和其他可能不自然包含描述性文本的 widget。
视图的无障碍功能
为了增强无障碍服务(例如屏幕阅读器)可用的信息,您可以在自定义 View 组件中为无障碍事件实现新的回调方法。
首先请务必注意,sendAccessibilityEvent() 方法的行为在 Android 4.0 中发生了变化。与之前的 Android 版本一样,当用户在设备上启用无障碍服务并且发生点击或悬停等输入事件时,系统会通过调用 sendAccessibilityEvent() 来通知相应的视图。之前,sendAccessibilityEvent() 的实现会初始化 AccessibilityEvent 并将其发送到 AccessibilityManager。新行为涉及一些额外的回调方法,这些方法允许视图及其父级向事件添加更多上下文信息:
- 调用时,
sendAccessibilityEvent()和sendAccessibilityEventUnchecked()方法会遵从onInitializeAccessibilityEvent()。View的自定义实现可能需要实现onInitializeAccessibilityEvent(),以便将其他无障碍信息附加到AccessibilityEvent,但还应调用超级实现来提供默认信息,例如标准内容说明、项目索引等。 不过,您不应在此回调中添加其他文本内容,因为这会在下一步中完成。 - 初始化后,如果该事件是应填充文本信息的几种类型之一,则视图会收到对
dispatchPopulateAccessibilityEvent()的调用,该调用会遵从onPopulateAccessibilityEvent()回调。如果
android:contentDescription文本缺失或不足,View的自定义实现通常应实现onPopulateAccessibilityEvent(),以向AccessibilityEvent添加额外的文本内容。如需向AccessibilityEvent添加更多文本说明,请调用getText()。add()。 - 此时,
View会通过对父级视图调用requestSendAccessibilityEvent(),将事件沿视图层次结构向上传递。然后,每个父视图都有机会通过添加AccessibilityRecord来扩充无障碍信息,直到最终到达根视图,根视图会使用sendAccessibilityEvent()将事件发送到AccessibilityManager。
除了上述新方法(在扩展 View 类时非常有用)之外,您还可以通过扩展 AccessibilityDelegate 并使用 setAccessibilityDelegate() 在视图上设置它,从而在任何 View 上拦截这些事件回调。
这样,视图中的每个无障碍方法都会将调用推迟到委托中的相应方法。例如,当视图收到对 onPopulateAccessibilityEvent() 的调用时,它会将该调用传递给 View.AccessibilityDelegate 中的同一方法。委托未处理的所有方法都会返回给视图,以执行默认行为。这样,您只需替换任何给定视图所需的方法,而无需扩展 View 类。
如果您想保持与 4.0 之前的 Android 版本的兼容性,同时支持新的无障碍功能 API,则可以使用最新版本的 v4 支持库(在兼容性软件包 r4 中),该库提供了一组实用程序类,这些类以向后兼容的设计提供新的无障碍功能 API。
辅助功能服务
如果您正在开发无障碍服务,则有关各种无障碍事件的信息已显著扩展,以便为用户提供更高级的无障碍反馈。具体而言,系统会根据视图组合生成事件,从而提供更好的上下文信息,并允许无障碍服务遍历视图层次结构,以获取更多视图信息并处理特殊情况。
如果您正在开发无障碍服务(例如屏幕阅读器),则可以通过以下过程访问其他内容信息并遍历视图层次结构:
- 收到来自应用的
AccessibilityEvent后,调用AccessibilityEvent.getRecord()以检索特定AccessibilityRecord(可能有多个记录附加到该事件)。 - 您可以从
AccessibilityEvent或单个AccessibilityRecord调用getSource(),以检索AccessibilityNodeInfo对象。AccessibilityNodeInfo表示窗口内容的单个节点,其格式可让您查询该节点的相关无障碍信息。从AccessibilityEvent返回的AccessibilityNodeInfo对象描述事件来源,而AccessibilityRecord中的来源描述事件来源的前身。 - 借助
AccessibilityNodeInfo,您可以查询有关它的信息,调用getParent()或getChild()来遍历视图层次结构,甚至可以向节点添加子视图。
为了让您的应用作为无障碍服务向系统发布自身,它必须声明与 AccessibilityServiceInfo 对应的 XML 配置文件。如需详细了解如何创建无障碍服务,请参阅 AccessibilityService;如需了解 XML 配置,请参阅 SERVICE_META_DATA。
其他无障碍功能 API
如果您对设备的无障碍状态感兴趣,AccessibilityManager 提供了一些新的 API,例如:
AccessibilityManager.AccessibilityStateChangeListener是一个接口,可让您在启用或停用无障碍功能时收到回调。getEnabledAccessibilityServiceList()提供有关当前启用了哪些无障碍服务的信息。isTouchExplorationEnabled()会告知您是否已启用“轻触探索”模式。
拼写检查工具服务
借助新的拼写检查工具框架,应用可以采用与输入法框架(适用于 IME)类似的方式创建拼写检查工具。如需创建新的拼写检查工具,您必须实现一个扩展 SpellCheckerService 的服务,并扩展 SpellCheckerService.Session 类,以便根据接口的回调方法提供的文本提供拼写建议。在 SpellCheckerService.Session 回调方法中,您必须以 SuggestionsInfo 对象的形式返回拼写建议。
具有拼写检查工具服务的应用必须按照服务要求声明 BIND_TEXT_SERVICE 权限。
此服务还必须声明一个 intent 过滤器,其中 <action
android:name="android.service.textservice.SpellCheckerService" /> 作为 intent 的操作,并且应包含一个 <meta-data> 元素,用于声明拼写检查工具的配置信息。
如需查看示例代码,请参阅拼写检查工具服务示例应用和拼写检查工具客户端示例应用。
文字转语音引擎
Android 的文字转语音 (TTS) API 得到了显著扩展,使应用能够更轻松地实现自定义 TTS 引擎,而想要使用 TTS 引擎的应用则有几个新的 API 可用于选择引擎。
使用文字转语音引擎
在之前的 Android 版本中,您可以使用 TextToSpeech 类通过系统提供的 TTS 引擎执行文字转语音 (TTS) 操作,也可以使用 setEngineByPackageName() 设置自定义引擎。在 Android 4.0 中,setEngineByPackageName() 方法已被弃用,您现在可以使用接受 TTS 引擎软件包名称的新 TextToSpeech 构造函数来指定要使用的引擎。
您还可以使用 getEngines() 查询可用的 TTS 引擎。此方法会返回一个 TextToSpeech.EngineInfo 对象列表,其中包含引擎的图标、标签和软件包名称等元数据。
构建文字转语音引擎
以前,自定义引擎需要使用未记录的原生头文件构建。Android 4.0 包含一套完整的框架 API,可用于构建 TTS 引擎。
基本设置需要实现响应 INTENT_ACTION_TTS_SERVICE intent 的 TextToSpeechService。TTS 引擎的主要工作是在扩展 TextToSpeechService 的服务中的 onSynthesizeText() 回调期间完成的。系统会向此方法传递两个对象:
SynthesisRequest:其中包含各种数据,包括要合成的文本、语言区域、语速和音高。SynthesisCallback:这是 TTS 引擎以流式音频形式提供生成的语音数据的接口。首先,引擎必须调用start(),以指示引擎已准备好传送音频,然后调用audioAvailable(),并在字节缓冲区中向其传递音频数据。当引擎通过缓冲区传递完所有音频后,调用done()。
由于框架现在支持用于创建 TTS 引擎的真正 API,因此对原生代码实现的支持已被移除。请参阅有关兼容性层的博文,了解如何使用兼容性层将旧版 TTS 引擎转换为新框架。
如需查看使用新 API 的 TTS 引擎示例,请参阅 Text To Speech Engine 示例应用。
网络使用
Android 4.0 可让用户精确了解其应用使用的网络流量。 “设置”应用提供的控件可让用户管理网络流量消耗的设定限制,甚至可以禁止个别应用使用后台流量。为避免用户停用应用在后台访问数据的功能,您应制定策略来高效使用数据连接,并根据可用的连接类型调整使用情况。
如果您的应用执行大量网络事务,您应提供用户设置,让用户能够控制应用的数据习惯,例如应用同步数据的频率、是否仅在连接到 Wi-Fi 时执行上传/下载、是否在漫游时使用数据等。获得这些控制功能后,用户在接近其流量上限时就不太可能停用您的应用对流量的访问权限,因为用户可以精确控制此应用使用的流量大小。
如果您为这些设置提供了偏好设置 activity,则应在其清单声明中包含一个针对 ACTION_MANAGE_NETWORK_USAGE 操作的 intent 过滤器。例如:
<activity android:name="DataPreferences" android:label="@string/title_preferences"> <intent-filter> <action android:name="android.intent.action.MANAGE_NETWORK_USAGE" /> <category android:name="android.intent.category.DEFAULT" /> </intent-filter> </activity>
此 intent 过滤器向系统指示,这是控制应用流量消耗的 activity。这样,当用户从“设置”应用中检查您的应用正在使用多少数据时,系统会显示一个“查看应用设置”按钮,该按钮会启动您的偏好设置 activity,以便用户可以优化您的应用使用的数据量。
另请注意,getBackgroundDataSetting() 现已废弃,并且始终返回 true,请改用 getActiveNetworkInfo()。在尝试任何网络事务之前,您应始终调用 getActiveNetworkInfo() 以获取表示当前网络的 NetworkInfo,并查询 isConnected() 以检查设备是否已连接。然后,您可以检查其他连接属性,例如设备是否正在漫游或已连接到 Wi-Fi。
企业
Android 4.0 通过以下功能扩展了企业应用的功能。
VPN 服务
借助新的 VpnService,应用可以构建自己的 VPN(虚拟专用网),作为 Service 运行。VPN 服务会为具有自己的地址和路由规则的虚拟网络创建一个接口,并使用文件描述符执行所有读取和写入操作。
如需创建 VPN 服务,请使用 VpnService.Builder,它可让您指定网络地址、DNS 服务器、网络路由等。完成后,您可以通过调用 establish() 来建立接口,该方法会返回 ParcelFileDescriptor。
由于 VPN 服务可以拦截数据包,因此存在安全隐患。因此,如果您实现 VpnService,则您的服务必须请求 BIND_VPN_SERVICE,以确保只有系统才能与其绑定(只有系统会被授予此权限,应用无法请求此权限)。然后,用户必须在系统设置中手动启用您的 VPN 服务,才能使用该服务。
设备政策
管理设备限制的应用现在可以使用 setCameraDisabled() 和 USES_POLICY_DISABLE_CAMERA 属性(通过政策配置文件中的 <disable-camera /> 元素应用)停用相机。
证书管理
新的 KeyChain 类提供了可让您在系统密钥库中导入和访问证书的 API。证书可简化客户端证书(用于验证用户身份)和证书授权机构证书(用于验证服务器身份)的安装。网络浏览器或电子邮件客户端等应用可以访问已安装的证书,以便向服务器验证用户身份。如需了解详情,请参阅 KeyChain 文档。
设备传感器
Android 4.0 中添加了两种新的传感器类型:
TYPE_AMBIENT_TEMPERATURE:一种温度传感器,用于提供环境(室内)温度(以摄氏度为单位)。TYPE_RELATIVE_HUMIDITY:湿度传感器,以百分比形式提供相对环境(房间)湿度。
如果设备同时具有 TYPE_AMBIENT_TEMPERATURE 和 TYPE_RELATIVE_HUMIDITY 传感器,您可以使用它们来计算露点和绝对湿度。
之前的温度传感器 TYPE_TEMPERATURE 已废弃。您应改用 TYPE_AMBIENT_TEMPERATURE 传感器。
此外,Android 的三个合成传感器也得到了极大改进,现在延迟更低,输出更流畅。这些传感器包括重力传感器 (TYPE_GRAVITY)、旋转矢量传感器 (TYPE_ROTATION_VECTOR) 和线性加速度传感器 (TYPE_LINEAR_ACCELERATION)。改进后的传感器依靠陀螺仪传感器来改进其输出,因此这些传感器仅出现在具有陀螺仪的设备上。
操作栏
ActionBar 已更新,可支持多项新行为。最重要的是,在小屏幕上运行时,系统会妥善管理操作栏的大小和配置,以便在所有屏幕尺寸上提供最佳用户体验。例如,当屏幕较窄时(比如手机处于竖屏模式时),操作栏的导航标签页会显示在“堆叠栏”中,该栏会直接显示在主操作栏下方。您还可以选择启用“拆分操作栏”,当屏幕较窄时,该操作栏会将所有操作项放置在屏幕底部的单独栏中。
拆分操作栏
如果您的操作栏包含多个操作项,那么在窄屏幕上,操作栏可能无法容纳所有操作项,因此系统会将更多操作项放入溢出菜单中。不过,Android 4.0 允许您启用“拆分操作栏”,以便在屏幕底部的单独栏中显示更多操作项。如需启用拆分操作栏,请将 android:uiOptions 与 "splitActionBarWhenNarrow" 添加到清单文件中的 <application> 标记或各个 <activity> 标记中。启用后,当屏幕较窄时,系统会在屏幕底部为所有待办项添加一个额外的栏(主操作栏中不会显示任何待办项)。
如果您想使用 ActionBar.Tab API 提供的导航标签页,但不需要顶部的操作栏(您只想让标签页显示在顶部),请按照上述说明启用拆分操作栏,并调用 setDisplayShowHomeEnabled(false) 以停用操作栏中的应用图标。主操作栏中没有任何内容后,它就会消失,只剩下顶部的导航标签页和屏幕底部的待办项。
操作栏样式
如果您想对操作栏应用自定义样式,可以使用新的样式属性 backgroundStacked 和 backgroundSplit 分别为堆叠栏和拆分栏应用背景可绘制对象或颜色。您还可以在运行时使用 setStackedBackgroundDrawable() 和 setSplitBackgroundDrawable() 设置这些样式。
操作提供程序
借助新的 ActionProvider 类,您可以为待办项创建专用处理程序。操作提供程序可以为与其关联的每个待办项定义操作视图、默认操作行为和子菜单。如果您想创建具有动态行为(例如可变操作视图、默认操作或子菜单)的操作项,那么扩展 ActionProvider 是创建可重用组件的理想解决方案,而不是在 fragment 或 activity 中处理各种操作项转换。
例如,ShareActionProvider 是 ActionProvider 的扩展,可帮助您在操作栏中实现“分享”操作。您可以使用此操作提供程序来呈现一个操作视图,其中包含一个下拉列表,列出了处理 ACTION_SEND intent 的应用,而不是使用调用 ACTION_SEND intent 的传统操作项。当用户选择要用于该操作的应用时,ShareActionProvider 会记住该选择,并在操作视图中提供该选择,以便用户更快地访问该应用进行分享。
如需为操作项声明操作提供程序,请在 activity 选项菜单的 <item> 元素中添加 android:actionProviderClass 属性,并将操作提供程序的类名称作为其值。例如:
<item android:id="@+id/menu_share"
android:title="Share"
android:showAsAction="ifRoom"
android:actionProviderClass="android.widget.ShareActionProvider" />在 activity 的 onCreateOptionsMenu() 回调方法中,从菜单项中检索操作提供程序的实例,并设置 intent:
Kotlin
override fun onCreateOptionsMenu(menu: Menu): Boolean { menuInflater.inflate(R.menu.options, menu) val shareActionProvider = menu.findItem(R.id.menu_share)?.actionProvider as? ShareActionProvider // Set the share intent of the share action provider. shareActionProvider?.setShareIntent(createShareIntent()) ... return super.onCreateOptionsMenu(menu) }
Java
public boolean onCreateOptionsMenu(Menu menu) { getMenuInflater().inflate(R.menu.options, menu); ShareActionProvider shareActionProvider = (ShareActionProvider) menu.findItem(R.id.menu_share).getActionProvider(); // Set the share intent of the share action provider. shareActionProvider.setShareIntent(createShareIntent()); ... return super.onCreateOptionsMenu(menu); }
如需查看使用 ShareActionProvider 的示例,请参阅 ApiDemos 中的 ActionBarShareActionProviderActivity。
可折叠操作视图
提供操作视图的待办项现在可以在其操作视图状态和传统待办项状态之间切换。以前,只有 SearchView 在用作操作视图时支持收起,但现在您可以为任何待办项添加操作视图,并在展开状态(操作视图可见)和收起状态(待办项可见)之间切换。
如需声明包含操作视图的操作项可收起,请在菜单 XML 文件中 <item> 元素的 android:showAsAction 属性中添加 "collapseActionView" 标志。
如需在操作视图在展开和收起之间切换时接收回调,请通过调用 setOnActionExpandListener() 向相应的 MenuItem 注册 MenuItem.OnActionExpandListener 的实例。通常,您应该在 onCreateOptionsMenu() 回调期间执行此操作。
如需控制可收起的操作视图,您可以对相应的 MenuItem 调用 collapseActionView() 和 expandActionView()。
创建自定义操作视图时,您还可以实现新的 CollapsibleActionView 接口,以便在视图展开和收起时接收回调。
适用于操作栏的其他 API
setHomeButtonEnabled()可让您指定图标/徽标是否用作返回主屏幕或“向上”导航的按钮(传递“true”可使其用作按钮)。setIcon()和setLogo()允许您在运行时定义操作栏图标或徽标。Fragment.setMenuVisibility()可让您启用或停用 fragment 声明的选项菜单项的可见性。如果 fragment 已添加到 activity 中但不可见,则此方法非常有用,因为菜单项应该隐藏。FragmentManager.invalidateOptionsMenu()可让您在 fragment 生命周期的各个状态期间使 activity 选项菜单失效,在这些状态下,可能无法使用Activity中的等效方法。
界面和视图
Android 4.0 引入了各种新视图和其他界面组件。
GridLayout
GridLayout 是一个新的视图组,可将子视图放置在矩形网格中。与 TableLayout 不同,GridLayout 依赖于平面层次结构,不使用表格行等中间视图来提供结构。相反,子元素会指定它们应占据的行和列(单元格可以跨多个行和/或列),并且默认情况下会按顺序在网格的行和列中布局。
GridLayout 方向决定了默认情况下是水平还是垂直布局连续子级。您可以通过使用新 Space 视图的实例或在子视图上设置相关外边距参数来指定子视图之间的间距。
如需查看使用 GridLayout 的示例,请参阅 ApiDemos。
TextureView
TextureView 是一个新视图,可让您显示内容流,例如视频或 OpenGL 场景。虽然 TextureView 与 SurfaceView 类似,但其独特之处在于,它的行为类似于常规视图,而不是创建单独的窗口,因此您可以像对待任何其他 View 对象一样对待它。例如,您可以应用转换、使用 ViewPropertyAnimator 为其添加动画效果,或使用 setAlpha() 调整其不透明度。
请注意,TextureView 仅在硬件加速窗口中有效。
如需了解详情,请参阅 TextureView 文档。
切换微件
新的 Switch widget 是一个双状态切换开关,用户可以将其拖动到一侧或另一侧(或直接点按),以便在两种状态之间切换选项。
您可以使用 android:textOn 和 android:textOff 属性来指定开关处于开启和关闭设置时要显示的文本。借助 android:text 属性,您还可以在开关旁边放置标签。
如需查看使用开关的示例,请参阅 switches.xml 布局文件和相应的 Switches activity。
弹出式菜单
Android 3.0 引入了 PopupMenu,用于创建在您指定的锚点(通常在所选项的位置)弹出的简短上下文菜单。Android 4.0 通过一些实用功能扩展了 PopupMenu:
- 现在,您可以使用
inflate()轻松地从 XML 菜单资源中膨胀弹出式菜单的内容,并向其传递菜单资源 ID。 - 现在,您还可以创建一个
PopupMenu.OnDismissListener,以便在菜单关闭时接收回调。
偏好设置
新的 TwoStatePreference 抽象类用作提供双状态选择选项的偏好设置的基础。新的 SwitchPreference 是 TwoStatePreference 的扩展,它在偏好设置视图中提供了一个 Switch widget,让用户无需打开额外的偏好设置屏幕或对话框即可开启或关闭设置。例如,“设置”应用会使用 SwitchPreference 来显示 WLAN 和蓝牙设置。
系统主题
现在,所有以 Android 4.0 为目标平台(通过将 targetSdkVersion 或 minSdkVersion 设置为 "14" 或更高级别)的应用的默认主题均为“设备默认”主题:Theme.DeviceDefault。这可能是深色 Holo 主题,也可能是特定设备定义的其他深色主题。
在运行同一 Android 版本时,Theme.Holo 系列主题在不同设备上不会发生变化。如果您明确将任何 Theme.Holo 主题应用于 activity,则可以放心,这些主题在同一平台版本的不同设备上不会改变其特性。
如果您希望应用与整体设备主题融为一体(例如,当不同的 OEM 为系统提供不同的默认主题时),则应明确应用 Theme.DeviceDefault 系列中的主题。
“选项”菜单按钮
从 Android 4.0 开始,您会注意到手机不再需要“菜单”硬件按钮。 不过,如果您的现有应用提供选项菜单,并且希望有一个“菜单”按钮,则无需担心这一点。为确保现有应用继续按预期运行,系统会为专为旧版 Android 设计的应用提供屏幕上的“菜单”按钮。
为了提供最佳用户体验,新应用和更新后的应用应改用 ActionBar 来提供对菜单项的访问权限,并将 targetSdkVersion 设置为 "14",以利用最新的框架默认行为。
系统界面可见性控件
自 Android 早期版本开始,系统就一直管理着一个名为状态栏的界面组件,该组件位于手机设备的顶部,用于提供运营商信号、时间和通知等信息。Android 3.0 为平板电脑设备添加了系统栏,该栏位于屏幕底部,用于提供系统导航控件(例如“主屏幕”和“返回”),以及传统上由状态栏提供的元素的界面。在 Android 4.0 中,系统提供了一种名为导航栏的新型系统界面。您可以将导航栏视为专为手机设计的系统栏的调整版本,它为没有硬件对应项的设备提供导航控件,以便用户在系统中导航,但它不包含系统栏的通知界面和设置控件。因此,提供导航栏的设备在顶部也会有状态栏。
到目前为止,您可以使用 FLAG_FULLSCREEN 标志在手机上隐藏状态栏。在 Android 4.0 中,用于控制系统栏可见性的 API 已更新,以便更好地反映系统栏和导航栏的行为:
SYSTEM_UI_FLAG_LOW_PROFILE标志会取代STATUS_BAR_HIDDEN标志。设置此标志后,系统栏或导航栏会启用“低调”模式。导航按钮会变暗,系统栏中的其他元素也会隐藏。启用此功能有助于打造更具沉浸感的游戏,而不会受到系统导航按钮的干扰。SYSTEM_UI_FLAG_VISIBLE标志取代了STATUS_BAR_VISIBLE标志,用于请求显示系统栏或导航栏。SYSTEM_UI_FLAG_HIDE_NAVIGATION是一个新标志,用于请求完全隐藏导航栏。请注意,此方法仅适用于某些手机使用的导航栏(它不会隐藏平板电脑上的系统栏)。系统一收到用户输入,导航栏就会返回到视图中。因此,此模式主要适用于视频播放或需要整个屏幕但不需要用户输入的其他情况。
您可以通过在 activity 中的任何视图上调用 setSystemUiVisibility(),为系统栏和导航栏设置上述每个标志。只要您的窗口具有输入焦点,窗口管理器就会将窗口中所有视图的所有标志组合(或运算)在一起,并将其应用于系统界面。当您的窗口失去输入焦点(用户离开您的应用或出现对话框)时,您的标志将不再有效。
同样,如果您从视图层次结构中移除这些视图,其标志将不再适用。
如需将 activity 中的其他事件与系统界面的可见性变化同步(例如,在系统界面隐藏时隐藏操作栏或其他界面控件),您应注册一个 View.OnSystemUiVisibilityChangeListener,以便在系统栏或导航栏的可见性发生变化时收到通知。
如需查看不同系统界面选项的演示,请参阅 OverscanActivity 类。
输入框架
Android 4.0 增加了对光标悬停事件以及新的触控笔和鼠标按钮事件的支持。
悬停事件
View 类现在支持“悬停”事件,以便通过使用指控设备(例如鼠标或其他驱动屏幕光标的设备)实现更丰富的互动。
如需在视图上接收悬停事件,请实现 View.OnHoverListener 并将其注册到 setOnHoverListener()。当视图上发生悬停事件时,您的监听器会收到对 onHover() 的调用,其中提供接收到事件的 View 以及描述所发生悬停事件类型的 MotionEvent。悬停事件可以是以下任一事件:
如果 View.OnHoverListener 处理悬停事件,则应从 onHover() 返回 true。如果监听器返回 false,则悬停事件将照常分派到父视图。
如果您的应用使用会根据当前状态更改外观的按钮或其他 widget,您现在可以在状态列表可绘制对象中使用 android:state_hovered 属性,以便在光标悬停在视图上时提供不同的背景可绘制对象。
如需查看新悬停事件的演示,请参阅 ApiDemos 中的 Hover 类。
触控笔和鼠标按钮事件
Android 现在提供了一些 API,用于接收来自触控笔输入设备(例如数字化仪平板电脑外围设备或支持触控笔的触摸屏)的输入。
触控笔输入的操作方式与触控或鼠标输入类似。当触控笔与数字化仪接触时,应用会收到触摸事件,就像使用手指触摸显示屏时一样。当触控笔悬停在数字化仪上方时,应用会收到悬停事件,就像在未按下任何按钮的情况下鼠标指针在显示屏上移动时一样。
您的应用可以通过使用 getToolType() 查询 MotionEvent 中与每个指针关联的“工具类型”,来区分手指、鼠标、触控笔和橡皮擦输入。当前定义的工具类型包括:TOOL_TYPE_UNKNOWN、TOOL_TYPE_FINGER、TOOL_TYPE_MOUSE、TOOL_TYPE_STYLUS 和 TOOL_TYPE_ERASER。通过查询工具类型,您的应用可以选择以不同于手指或鼠标输入的方式处理触控笔输入。
应用还可以通过使用 getButtonState() 查询 MotionEvent 的“按钮状态”来查询按下了哪些鼠标或触控笔按钮。当前定义的按钮状态包括:BUTTON_PRIMARY、BUTTON_SECONDARY、BUTTON_TERTIARY、BUTTON_BACK 和 BUTTON_FORWARD。为方便起见,鼠标的后退和前进按钮会自动映射到 KEYCODE_BACK 和 KEYCODE_FORWARD 键。您的应用可以处理这些按键,以支持基于鼠标按钮的后退和前进导航。
除了精确测量接触点的位置和压力之外,某些触控笔输入设备还会报告触控笔笔尖与数字化仪之间的距离、触控笔倾斜角度和触控笔方向角度。您的应用可以使用 getAxisValue() 以及轴代码 AXIS_DISTANCE、AXIS_TILT 和 AXIS_ORIENTATION 查询此信息。
如需查看工具类型、按钮状态和新轴代码的演示,请参阅 ApiDemos 中的 TouchPaint 类。
属性
新的 Property 类提供了一种快速、高效且简单的方法,用于在任何对象上指定属性,使调用方能够以通用方式在目标对象上设置/获取值。它还允许传递字段/方法引用,并允许代码设置/获取属性值,而无需了解字段/方法的详细信息。
例如,如果您想设置对象 foo 上的字段 bar 的值,之前需要执行以下操作:
Kotlin
foo.bar = value
Java
foo.bar = value;
如果您想调用底层私有字段 bar 的 setter,之前需要执行以下操作:
Kotlin
foo.setBar(value)
Java
foo.setBar(value);
不过,如果您想传递 foo 实例并让其他一些代码设置 bar 值,在 Android 4.0 之前确实无法做到。
使用 Property 类,您可以在类 Foo 上声明 Property 对象 BAR,以便在类 Foo 的实例 foo 上设置字段,如下所示:
Kotlin
BAR.set(foo, value)
Java
BAR.set(foo, value);
View 类现在利用 Property 类,让您可以设置各种字段,例如 Android 3.0 中添加的转换属性(ROTATION、ROTATION_X、TRANSLATION_X 等)。
ObjectAnimator 类还使用 Property 类,因此您可以使用 Property 创建 ObjectAnimator,这比基于字符串的方法更快、更高效且更具类型安全性。
硬件加速
从 Android 4.0 开始,如果您的应用已将 targetSdkVersion 或 minSdkVersion 设置为 "14" 或更高版本,则系统会默认启用所有窗口的硬件加速。硬件加速通常会使动画和滚动更流畅,并且可提高整体性能和对用户互动的响应能力。
如有必要,您可以使用 hardwareAccelerated 属性为单个 <activity> 元素或 <application> 元素手动停用硬件加速。您也可以通过调用 setLayerType(LAYER_TYPE_SOFTWARE) 为单个视图停用硬件加速。
如需详细了解硬件加速(包括不受支持的绘制操作列表),请参阅硬件加速文档。
JNI 变更
在以前的 Android 版本中,JNI 局部引用不是间接句柄,Android 使用的是直接指针。只要垃圾回收器不移动对象,这就不是问题,但它似乎可以正常运行,因为它可以编写有 bug 的代码。在 Android 4.0 中,系统现在使用间接引用来检测这些 bug。
JNI 提示中的“局部引用和全局引用”介绍了 JNI 局部引用的来龙去脉。在 Android 4.0 中,CheckJNI 得到了增强,可以检测这些错误。请关注 Android 开发者博客,了解即将发布的有关 JNI 引用常见错误及修复方法的博文。
JNI 实现中的这项变更仅会影响通过将 targetSdkVersion 或 minSdkVersion 设置为 "14" 或更高级别来以 Android 4.0 为目标平台的应用。如果您将这些属性设置为任何较低的值,则 JNI 局部引用的行为与在先前版本中相同。
WebKit
- WebKit 已更新至 534.30 版
WebView和内置浏览器支持印度语系字体(梵文、孟加拉文和泰米尔文,包括组合字形所需的复杂字符支持)- 在
WebView和内置浏览器中支持埃塞俄比亚语、格鲁吉亚语和亚美尼亚语字体 - 对 WebDriver 的支持使您可以更轻松地测试使用
WebView的应用
Android 浏览器
浏览器应用添加了以下功能来支持 Web 应用:
- 更新了 V8 JavaScript 编译器,以提升性能
- 此外,从 Android 3.0 沿用下来的其他显著增强功能现在也可在手机上使用:
权限
以下是新权限:
ADD_VOICEMAIL:允许语音信箱服务向设备添加语音信箱消息。BIND_TEXT_SERVICE:实现SpellCheckerService的服务必须为自身请求此权限。BIND_VPN_SERVICE:实现VpnService的服务必须为自身请求此权限。- android.Manifest.permission#READ_PROFILE:提供对
ContactsContract.Profile提供程序的读取权限。 - android.Manifest.permission#WRITE_PROFILE:提供对
ContactsContract.Profile提供程序的写入权限。
设备功能
以下是新的设备功能:
FEATURE_WIFI_DIRECT:声明应用使用 Wi-Fi 进行点对点通信。
如需详细了解 Android 4.0(API 级别 14)中的所有 API 变更,请参阅 API 差异报告。
旧版 API
除了上述所有功能之外,Android 4.0 自然也支持之前版本的所有 API。 由于 Android 3.x 平台仅适用于大屏设备,因此如果您主要针对手机进行开发,则可能不了解这些近期版本中添加到 Android 的所有 API。
以下是一些您可能错过的最值得关注的 API,它们现在也适用于手机:
- Android 3.0
-
Fragment:一个框架组件,可让您将 activity 的不同元素分离到定义其自身界面和生命周期的独立模块中。请参阅 fragment 开发者指南。ActionBar:activity 窗口顶部传统标题栏的替代项。它在左上角包含应用徽标,并为菜单项提供了新界面。请参阅操作栏开发者指南。Loader:一个框架组件,可与界面组件结合使用,以便异步加载数据,从而在不阻塞主线程的情况下动态加载数据。请参阅加载器开发者指南。- 系统剪贴板:应用可以向系统级剪贴板复制数据(不仅仅是文本),也可以从系统级剪贴板粘贴数据。剪贴数据可以是纯文本、URI 或 intent。请参阅复制和粘贴开发者指南。
- 拖放:一组内置于视图框架中的 API,可简化拖放操作。请参阅拖放开发者指南。
- 全新的灵活动画框架可让您为任何对象(View、Drawable、Fragment、Object 或任何其他对象)的任意属性添加动画效果,并定义动画的各个方面,例如时长、插值、重复等。新框架让 Android 中的动画比以往更简单。请参阅属性动画开发者指南。
- RenderScript 图形和计算引擎:RenderScript 在原生级别提供高性能 3D 图形渲染和计算 API,您可以使用 C 语言(C99 标准)编写,从而提供您期望从原生环境获得的性能,同时在各种 CPU 和 GPU 之间保持可移植性。请参阅 RenderScript 开发者指南。
- 硬件加速 2D 图形:现在,您可以通过在清单元素的
<application>元素或单个<activity>元素中设置 {android:hardwareAccelerated="true"},为应用启用 OpenGL 渲染程序。这样可使动画和流畅滚动更流畅,并可提高整体性能和对用户互动的响应能力。注意:如果您将应用的
minSdkVersion或targetSdkVersion设置为"14"或更高级别,则系统会默认启用硬件加速。 - 还有更多精彩内容。如需了解详情,请参阅 Android 3.0 平台说明。
- Android 3.1
-
- USB API:强大的新 API,可将连接的外围设备与 Android 应用集成。这些 API 基于平台内置的 USB 堆栈和服务,包括对 USB 主机和设备交互的支持。请参阅 USB 主机和配件开发者指南。
- MTP/PTP API:应用可以直接与外接摄像头和其他 PTP 设备交互,以便在设备连接和移除时接收通知、管理这些设备上的文件和存储空间,以及在这些设备之间传输文件和元数据。MTP API 实现了 MTP(媒体传输协议)规范的 PTP(图片传输协议)子集。请参阅
android.mtp文档。 - RTP API:Android 向其内置 RTP(实时传输协议)堆栈公开了一个 API,应用可使用该 API 来管理点播或交互式数据流。具体而言,提供 VOIP、一键通、会议和音频串流的应用可以使用该 API 发起会话,并通过任何可用网络传输或接收数据流。请参阅
android.net.rtp文档。 - 支持操纵杆和其他通用动作输入。
- 如需了解更多新 API,请参阅 Android 3.1 平台说明。
- Android 3.2
-
- 新的屏幕支持 API,让您可以更好地控制应用在不同屏幕尺寸下的显示方式。该 API 扩展了现有的屏幕支持模型,能够根据尺寸(以密度无关像素为单位,例如 600dp 或 720dp 宽)而不是通用屏幕尺寸(例如 large 或 xlarge)精确定位特定屏幕尺寸范围。例如,这对于帮助您区分 5 英寸设备和 7 英寸设备非常重要,因为这两种设备在传统上都会被归入“大”屏幕。请参阅博文用于管理屏幕尺寸的新工具。
<uses-feature>的新常量,用于声明横向或纵向屏幕方向要求。- 现在,设备“屏幕尺寸”配置会在屏幕方向更改期间发生变化。如果您的应用以目标 API 级别 13 或更高级别为目标平台,那么当您想处理
"orientation"配置变更时,还必须处理"screenSize"配置变更。如需了解详情,请参阅android:configChanges。 - 如需了解其他新 API,请参阅 Android 3.2 平台说明。
API 级别
Android 4.0 API 被分配了一个整数标识符 14,该标识符存储在系统本身中。 此标识符称为“API 级别”,可让系统在安装应用之前正确确定应用是否与系统兼容。
如需在应用中使用 Android 4.0 中引入的 API,您需要针对支持 API 级别 14 或更高级别的 Android 平台编译应用。根据您的需求,您可能还需要向 <uses-sdk> 元素添加 android:minSdkVersion="14" 属性。
如需了解详情,请参阅什么是 API 级别?