1page.title=API 概览
2page.keywords=预览版,sdk,兼容性
3page.tags=previewresources, androidm
4sdk.platform.apiLevel=22-mnc
5page.image=images/cards/card-api-overview_16-9_2x.png
6@jd:body
7
8
9<div id="qv-wrapper">
10<div id="qv">
11
12<h2>本文内容
13<a href="#" onclick="hideNestedItems('#toc44',this);return false;" class="header-toggle">
14        <span class="more">显示详细信息</span>
15        <span class="less" style="display:none">显示精简信息</span></a></h2>
16
17<ol id="toc44" class="hide-nested">
18  <li><a href="#app-linking">应用链接</a></li>
19  <li><a href="#backup">自动备份应用</a></li>
20  <li><a href="#authentication">身份验证</a>
21    <ol>
22      <li><a href="#fingerprint-authentication">指纹身份验证</a></li>
23      <li><a href="#confirm-credential">确认凭据</a></li>
24    </ol>
25  </li>
26  <li><a href="#direct-share">直接共享</a></li>
27  <li><a href="#voice-interactions">语音交互</a></li>
28  <li><a href="#assist">助手 API</a></li>
29  <li><a href="#notifications">通知</a></li>
30  <li><a href="#bluetooth-stylus">蓝牙触控笔支持</a></li>
31  <li><a href="#ble-scanning">改进的蓝牙低功耗扫描</a></li>
32  <li><a href="#hotspot">Hotspot 2.0 第 1 版支持</a></li>
33  <li><a href="#4K-display">4K 显示模式</a></li>
34  <li><a href="#behavior-themeable-colorstatelists">主题化 ColorStateList</a></li>
35  <li><a href="#audio">音频功能</a></li>
36  <li><a href="#video">视频功能</a></li>
37  <li><a href="#camera">相机功能</a>
38    <ol>
39      <li><a href="#flashlight">闪光灯 API</a></li>
40      <li><a href="#reprocessing">相机再处理</a></li>
41    </ol>
42  </li>
43  <li><a href="#afw">Android for Work 功能</a></li>
44</ol>
45
46<h2>API 差异</h2>
47<ol>
48<li><a href="{@docRoot}preview/download.html">API 级别 22 至 M 预览版&raquo;</a> </li>
49</ol>
50
51</div>
52</div>
53
54<p>M 开发者预览版可让您预览即将推出的 Android 平台版本为用户和应用开发者提供的新功能。
55
56本文旨在介绍其中最值得关注的 API。</p>
57
58<p>M 开发者预览版的适用对象是<strong>喜欢尝鲜的开发者</strong>和<strong>测试人员</strong>。
59如果您有兴趣影响 Android 框架的发展方向,<a href="{@docRoot}preview/setup-sdk.html">欢迎试用 M 开发者预览版</a>并向我们提供反馈!
60
61
62</p>
63
64<p class="caution"><strong>注意</strong>:请不要在 Google Play 商店中发布基于 M 开发者预览版的应用。
65</p>
66
67<p class="note"><strong>注:</strong>本文经常提及的一些类和方法在 <a href="{@docRoot}">developer.android.com</a> 上尚未提供相关参考资料。
68这些 API 元素在本文中设置为 {@code code style} 格式(不带超链接)。
69如需查看这些元素的初步 API 文档,请下载<a href="{@docRoot}preview/download.html#docs">预览版参考资料</a>。
70</p>
71
72<h3>重要的行为变更</h3>
73
74<p>如果您之前发布过 Android 应用,请注意您的应用可能受到平台变化的影响。
75</p>
76
77<p>如需了解完整信息,请参阅<a href="behavior-changes.html">行为变更</a>。</p>
78
79<h2 id="app-linking">应用链接</h2>
80<p>此预览版通过提供功能更强大的应用链接,增强了 Android 的意向系统。您可以利用此功能将应用与您拥有的某个 Web 域关联。
81平台可以根据此关联确定在处理特定 Web 链接时默认使用的应用,跳过提示用户选择应用的步骤。如需了解如何实现此功能,请参阅<a href="{@docRoot}preview/features/app-linking.html">应用链接</a>。
82
83
84
85
86<h2 id="backup">自动备份应用</h2>
87<p>现在,系统可以自动为应用执行完整数据备份和恢复。对于以 M 预览版为目标平台的应用,系统会默认启用此行为,您无需额外添加任何代码。
88如果用户删除其 Google 帐户,其备份数据也会被删除。
89如需了解该功能的工作方式以及配置文件系统备份内容的方法,请参阅<a href="{@docRoot}preview/backup/index.html">自动备份应用</a>。
90
91</p>
92
93<h2 id="authentication">身份验证</h2>
94<p>本预览版提供一些新的 API,在受支持的设备上,用户只需扫描其指纹即可完成身份验证,还可检查系统最后一次使用设备解锁机制(如锁屏密码)对用户进行身份验证是发生在多久之前。
95
96这些 API 可与 <a href="{@docRoot}training/articles/keystore.html">Android 密钥库系统</a>结合使用。
97</p>
98
99<h3 id="fingerprint-authentication">指纹身份验证</h3>
100
101<p>如需通过指纹扫描验证用户身份,请获取新增
102{@code android.hardware.fingerprint.FingerprintManager} 类的实例,并调用
103{@code FingerprintManager.authenticate()} 方法。您的应用必须运行在带有指纹传感器的兼容设备上。
104您必须在应用中实现指纹身份验证流的用户界面,并在 UI 中使用标准 Android 指纹图标。<a href="https://github.com/googlesamples/android-FingerprintDialog" class="external-link">示例应用</a>中包含有 Android 指纹图标 ({@code c_fp_40px.png})。请注意,如果您要开发多个使用指纹身份验证的应用,每个应用必须独立验证用户的指纹。
105
106
107
108
109</p>
110
111<p>如需在您的应用中使用此功能,请先在清单文件中添加 {@code USE_FINGERPRINT} 权限。
112</p>
113
114<pre>
115&lt;uses-permission
116        android:name="android.permission.USE_FINGERPRINT" /&gt;
117</pre>
118
119<img src="{@docRoot}preview/images/fingerprint-screen.png" srcset="{@docRoot}preview/images/fingerprint-screen.png 1x, {@docRoot}preview/images/fingerprint-screen_2x.png 2x" style="float:right; margin:0 0 10px 20px" width="282" height="476" />
120
121<p>如需查看指纹身份验证的应用实现,请参阅<a href="https://github.com/googlesamples/android-FingerprintDialog" class="external-link">指纹对话框示例</a>。
122
123</p>
124
125<p>如果您要测试此功能,请执行以下步骤:</p>
126<ol>
127<li>如果您尚未安装 Android SDK 工具 24.3 修订版,请执行此操作。</li>
128<li>转到<strong>设置 &gt; 安全 &gt; 指纹</strong>,然后按照登记说明在模拟器中登记新指纹。
129</li>
130<li>使用模拟器通过以下命令模拟指纹触摸事件。
131使用同一命令模拟锁屏上或应用中的指纹触摸事件。
132
133<pre class="no-prettyprint">
134adb -e emu finger touch &lt;finger_id&gt;
135</pre>
136<p>在 Windows 上,您可能需要运行带有
137{@code finger touch &lt;finger_id&gt;} 参数的 {@code telnet 127.0.0.1 &lt;emulator-id&gt;} 命令。
138</p>
139</li>
140</ol>
141
142<h3 id="confirm-credential">确认凭据</h3>
143<p>您的应用可以根据用户在多久之前最后一次解锁设备来验证其身份。此功能让用户不必费心记忆应用特定密码,您也无需实现自己的身份验证用户界面。
144
145您的应用应当利用此功能并结合实现公钥或私钥,以进行用户身份验证。
146</p>
147
148<p>如需设置成功验证用户身份后可再次使用同一密钥的超时持续时间,请在设置 {@link javax.crypto.KeyGenerator} 或
149{@link java.security.KeyPairGenerator} 时调用新增的
150{@code android.security.keystore.KeyGenParameterSpec.setUserAuthenticationValidityDurationSeconds()}
151 方法。
152此功能目前适用于对称加密操作。
153</p>
154
155<p>避免过多显示重新验证对话框 -- 您的应用应尝试先使用加密对象,如果超时到期,请使用
156{@link android.app.KeyguardManager#createConfirmDeviceCredentialIntent(java.lang.CharSequence, java.lang.CharSequence) createConfirmDeviceCredentialIntent()} 方法在您的应用内重新验证用户身份。
157
158
159</p>
160
161<p>如需查看此功能的应用实现,请参阅<a href="https://github.com/googlesamples/android-ConfirmCredential" class="external-link">确认凭据示例</a>。
162
163</p>
164
165<h2 id="direct-share">直接共享</h2>
166
167<img src="{@docRoot}preview/images/direct-share-screen.png" srcset="{@docRoot}preview/images/direct-share-screen.png 1x, {@docRoot}preview/images/direct-share-screen_2x.png 2x" style="float:right; margin:0 0 20px 30px" width="312" height="329" />
168
169<p>本预览版为您提供的 API 可让用户直观、快捷地进行共享。现在,您可以定义可在您的应用内启动特定活动的<em>直接共享目标</em>。这些直接共享目标通过“共享”<em></em>菜单公开给用户。
170
171此功能让用户可以向其他应用内的目标(如联系人)共享内容。
172例如,直接共享目标可以启动另一社交网络应用中的某个活动,让用户可以直接向该应用中的某位朋友或某个社区共享内容。
173
174</p>
175
176<p>如需启用直接共享目标,您必须定义一个类,用于扩展
177{@code android.service.} <br>
178{@code chooser.ChooserTargetService} 类。在清单文件中声明您的
179{@code ChooserTargetService}。在该声明内,指定
180{@code BIND_CHOOSER_TARGET_SERVICE} 权限和一个带有
181{@code SERVICE_INTERFACE} 操作的意向过滤器。</p>
182<p>以下示例展示了如何在清单文件中声明 {@code ChooserTargetService}。
183</p>
184<pre>
185&lt;service android:name=".ChooserTargetService"
186        android:label="&#64;string/service_name"
187        android:permission="android.permission.BIND_CHOOSER_TARGET_SERVICE"&gt;
188    &lt;intent-filter&gt;
189        &lt;action android:name="android.service.chooser.ChooserTargetService" /&gt;
190    &lt;/intent-filter&gt;
191&lt;/service&gt;
192</pre>
193
194<p>对于您想要向 {@code ChooserTargetService} 公开的每个活动,请在您的应用清单文件中为其添加一个名为
195{@code "android.service.chooser.chooser_target_service"} 的
196{@code &lt;meta-data&gt;} 元素。
197</p>
198
199<pre>
200&lt;activity android:name=".MyShareActivity”
201        android:label="&#64;string/share_activity_label"&gt;
202    &lt;intent-filter>
203        &lt;action android:name="android.intent.action.SEND" /&gt;
204    &lt;/intent-filter>
205&lt;meta-data
206        android:name="android.service.chooser.chooser_target_service"
207        android:value=".ChooserTargetService" /&gt;
208&lt;/activity>
209</pre>
210
211<h2 id="voice-interactions">语音交互</h2>
212<p>
213本预览版提供了一个新的语音交互 API,与
214<a href="https://developers.google.com/voice-actions/" class="external-link">语音操作</a>一起使用时,可让您为应用内建对话式语音体验。
215调用
216{@code android.app.Activity.isVoiceInteraction()} 方法可确定您的活动是否为响应语音操作而启动。
217如果是这样,则您的应用可以使用
218{@code android.app.VoiceInteractor} 类请求用户进行语音确认、从选项列表中进行选择以及执行其他操作。
219如需了解有关实现语音操作的更多信息,请参阅
220<a href="https://developers.google.com/voice-actions/interaction/" class="external-link">语音操作开发者网站</a>。
221</p>
222
223<h2 id="assist">助手 API</h2>
224<p>
225本预览版提供了一种让用户通过助手程序与应用进行互动的新方式。如需使用此功能,用户必须启用助手以使用当前上下文。
226启用后,用户可通过长按<strong>主页</strong>按钮在任何应用内召唤助手。
227</p>
228<p>您的应用可通过设置
229{@link android.view.WindowManager.LayoutParams#FLAG_SECURE} 标志选择不与助手共享当前上下文。除了平台传递给助手的一组标准信息外,您的应用还可利用新增的 {@code android.app.Activity.AssistContent} 类共享其他信息。
230
231</p>
232
233<p>如需为助手提供您的应用内的其他上下文,请执行以下步骤:</p>
234
235<ol>
236<li>实现 {@link android.app.Application.OnProvideAssistDataListener} 接口。</li>
237<li>利用
238{@link android.app.Application#registerOnProvideAssistDataListener(android.app.Application.OnProvideAssistDataListener) registerOnProvideAssistDataListener()} 注册此侦听器。</li>
239<li>如需提供特定于活动的上下文信息,请替代
240{@link android.app.Activity#onProvideAssistData(android.os.Bundle) onProvideAssistData()}
241 回调和新增的 {@code Activity.onProvideAssistContent()} 回调(可选操作)。
242</ol>
243
244<h2 id="notifications">通知</h2>
245<p>本预览版针对通知功能引入了下列 API 变更:</p>
246<ul>
247  <li>新增了 {@code NotificationListenerService.INTERRUPTION_FILTER_ALARMS} 过滤级别,它对应于新增的“仅闹铃”<em></em>免打扰模式。
248</li>
249  <li>新增了 {@code Notification.CATEGORY_REMINDER} 类别值,用于区分用户安排的提醒与其他事件 ({@link android.app.Notification#CATEGORY_EVENT}) 和闹铃 ({@link android.app.Notification#CATEGORY_ALARM})。
250
251
252</li>
253  <li>新增了 {@code android.graphics.drawable.Icon} 类,可通过 {@code Notification.Builder.setSmallIcon(Icon)} 方法和
254{@code Notification.Builder.setLargeIcon(Icon)} 方法附加到通知上。
255</li>
256  <li>新增了 {@code NotificationManager.getActiveNotifications()} 方法,让您的应用能够了解哪些通知目前处于活动状态。
257如需查看使用此功能的应用实现,请参阅<a href="https://github.com/googlesamples/android-ActiveNotifications" class="external-link">活动通知示例</a>。
258</li>
259</ul>
260
261<h2 id="bluetooth-stylus">蓝牙触控笔支持</h2>
262<p>本预览版改善了对用户使用蓝牙触控笔进行输入的支持。用户可将兼容的蓝牙触控笔与其手机或平板电脑配对并建立连接。
263连接后,来自触摸屏的位置信息将与来自触控笔的压力和按键信息融合,从而实现比单纯使用触摸屏更丰富的表达。
264
265您的应用可以通过在活动中注册新增的
266{@code View.onStylusButtonPressListener} 回调和 {@code GestureDetector.OnStylusButtonPressListener}
267 回调侦听触控笔按键动作并执行辅助操作。
268</p>
269
270<p>可使用 {@link android.view.MotionEvent} 方法和常量来检测触控笔按键交互:
271</p>
272<ul>
273<li>如果用户使用带按键的触控笔触按应用屏幕,
274{@link android.view.MotionEvent#getToolType(int) getTooltype()} 方法会返回
275{@link android.view.MotionEvent#TOOL_TYPE_STYLUS}。</li>
276<li>对于以 M 预览版为目标平台的应用,当用户按触控笔的主按键时,
277{@link android.view.MotionEvent#getButtonState() getButtonState()}
278 方法会返回 {@code MotionEvent.STYLUS_BUTTON_PRIMARY}。
279如果触控笔有辅助按键,当用户按下它时,同一方法会返回
280{@code MotionEvent.STYLUS_BUTTON_SECONDARY}。如果用户同时按下两个按键,该方法会同时返回通过 OR 运算符连接起来的两个值 ({@code STYLUS_BUTTON_PRIMARY|STYLUS_BUTTON_SECONDARY})。
281
282</li>
283<li>
284对于以较低平台版本为目标的应用,
285{@link android.view.MotionEvent#getButtonState() getButtonState()} 方法返回
286{@link android.view.MotionEvent#BUTTON_SECONDARY}(按下触控笔主按键时)、
287{@link android.view.MotionEvent#BUTTON_TERTIARY}(按下触控笔辅助按键时)之一或同时返回这两者。
288</li>
289</ul>
290
291<h2 id="ble-scanning">改进的蓝牙低功耗扫描</h2>
292<p>
293如果您的应用执行蓝牙低功耗扫描,可以使用新增的
294{@code android.bluetooth.le.ScanSettings.Builder.setCallbackType()} 方法指定您只希望在下列条件下通知回调:首次找到与设置的
295{@link android.bluetooth.le.ScanFilter} 匹配的播发数据包并且该数据包已有一段时间没有出现。
296
297这种扫描方法与旧平台版本中提供的方法相比更加节能。
298
299</p>
300
301<h2 id="hotspot">Hotspot 2.0 第 1 版支持</h2>
302<p>
303本预览版在 Nexus 6 和 Nexus 9 设备上添加了对 Hotspot 2.0 第 1 版规范的支持。如需在您的应用中设置 Hotspot 2.0 凭据,请使用新增的
304{@link android.net.wifi.WifiEnterpriseConfig} 类方法,如 {@code setPlmn()} 方法和
305{@code setRealm()} 方法。
306在 {@link android.net.wifi.WifiConfiguration} 对象中,您可以设置
307{@link android.net.wifi.WifiConfiguration#FQDN} 字段和 {@code providerFriendlyName} 字段。
308新增的 {@code ScanResult.PasspointNetwork} 属性可指示检测到的网络是否为 Hotspot 2.0 接入点。
309
310</p>
311
312<h2 id="4K-display">4K 显示模式</h2>
313<p>现在,平台允许应用在兼容硬件上请求将显示分辨率升级到 4K 渲染。
314如需查询当前物理分辨率,请使用新增的
315{@code android.view.Display.Mode} API。请注意,如果 UI 是以较低逻辑分辨率绘制并通过放大达到更高的物理分辨率,则
316{@code Display.Mode.getPhysicalWidth()} 方法返回的物理分辨率可能不同于 {@link android.view.Display#getSize(android.graphics.Point) getSize()} 所报告的逻辑分辨率。
317
318</p>
319
320<p>您可以通过设置应用窗口的 {@code WindowManager.LayoutParams.preferredDisplayModeId} 属性请求系统更改应用运行时的物理分辨率。
321如果您想切换到 4K 显示分辨率,此功能会很有帮助。
322在 4K 显示模式下,UI 仍然以原始分辨率(如 1080p)渲染,通过放大达到 4K,但
323{@link android.view.SurfaceView} 对象可能会以原生分辨率显示内容。
324</p>
325
326<h2 id="behavior-themeable-colorstatelists">主题化 ColorStateList</h2>
327<p>对于运行 M 预览版的设备,现在支持在
328{@link android.content.res.ColorStateList} 中使用主题属性。
329{@link android.content.res.Resources#getColorStateList(int) getColorStateList()} 方法和
330{@link android.content.res.Resources#getColor(int) getColor()} 方法已弃用。如果您要调用这些 API,请改为调用新增的 {@code Context.getColorStateList()} 方法或
331{@code Context.getColor()} 方法。
332还可在 v4 appcompat 库中通过 {@link android.support.v4.content.ContextCompat} 使用这些方法。
333</p>
334
335<h2 id="audio">音频功能</h2>
336
337<p>本预览版增强了 Android 上的音频处理功能,包括: </p>
338<ul>
339  <li>通过新增的 {@code android.media.midi} API 提供了对 <a href="http://en.wikipedia.org/wiki/MIDI" class="external-link">MIDI</a>
340 协议的支持。使用这些 API 可发送和接收 MIDI 事件。
341</li>
342  <li>新增了 {@code android.media.AudioRecord.Builder} 类和 {@code android.media.AudioTrack.Builder}
343 类,分别用于创建数字音频采集和回放对象,还可用于配置音频源和接收器属性来替代系统默认值。
344</li>
345  <li>用于关联音频和输入设备的 API 钩子。如果您的应用允许用户通过与 Android TV 相连的游戏控制器或遥控器启动语音搜索,此功能尤为有用。系统会在用户启动搜索时调用新增的 {@code android.app.Activity.onSearchRequested()} 回调。
346
347
348如需确定用户的输入设备是否内置麦克风,请从该回调检索 {@link android.view.InputDevice} 对象,然后调用新增的
349{@code InputDevice.hasMic()} 方法。
350</li>
351  <li>新增了 {@code android.media.AudioDevicesManager} 类,让您可以检索连接的所有源设备和接收器音频设备列表。
352如果您想让应用在音频设备连接或断开时收到通知,还可以指定一个
353{@code android.media.OnAudioDeviceConnectionListener} 对象。
354</li>
355</ul>
356
357<h2 id="video">视频功能</h2>
358<p>本预览版为视频处理 API 添加了新功能,包括:</p>
359<ul>
360<li>新增了 {@code android.media.MediaSync} 类,可帮助应用同步渲染音频流和视频流。
361音频缓冲区以非锁定方式提交,并通过回调返回。
362此外,它还支持动态回放速率。
363</li>
364<li>新增了 {@code MediaDrm.EVENT_SESSION_RECLAIMED} 事件,它表示应用打开的会话已被资源管理器收回。
365如果您的应用使用 DRM 会话,则应处理此事件,并确保不使用收回的会话。
366
367</li>
368<li>新增了 {@code MediaCodec.CodecException.ERROR_RECLAIMED} 错误代码,它表示资源管理器收回了编解码器使用的媒体资源。
369出现此异常时,必须释放编解码器,因为它已转入终止状态。
370
371</li>
372<li>新增了 {@code MediaCodecInfo.CodecCapabilities.getMaxSupportedInstances()} 接口,用于获取有关支持的编解码器实例最大并发数量的提示。
373
374</li>
375<li>新增了 {@code MediaPlayer.setPlaybackParams()} 方法,用于设置快动作回放或慢动作回放的媒体回放速率。
376此外,它还会随视频一起自动拉长或加速音频回放。
377</li>
378</ul>
379
380<h2 id="camera">相机功能</h2>
381<p>本预览版提供了下列用于访问相机闪光灯和相机图像再处理的新 API:
382</p>
383
384<h3 id="flashlight">闪光灯 API</h3>
385<p>如果相机设备带有闪光灯,您可以通过调用 {@code CameraManager.setTorchMode()}
386 方法,在不打开相机设备的情况下打开或关闭闪光灯的火炬模式。应用对闪光灯或相机设备不享有独占所有权。
387每当相机设备不可用,或者开启火炬的其他相机资源不可用时,火炬模式即会被关闭并变为不可用状态。
388
389其他应用也可调用 {@code setTorchMode()} 来关闭火炬模式。
390当最后一个开启火炬模式的应用关闭时,火炬模式就会被关闭。
391</p>
392
393<p>您可以注册一个回调,通过调用
394{@code CameraManager.registerTorchCallback()} 方法接收有关火炬模式状态的通知。第一次注册回调时,系统会立即调用它,并返回所有当前已知配备闪光灯的相机设备的火炬模式状态。
395
396如果成功开启或关闭火炬模式,系统会调用
397{@code CameraManager.TorchCallback.onTorchModeChanged()} 方法。</p>
398
399<h3 id="reprocessing">再处理 API</h3>
400<p>{@link android.hardware.camera2 Camera2} API 进行了扩展,以支持 YUV 和专用不透明格式图像再处理。
401您的应用通过 {@code CameraCharacteristics.REQUEST_AVAILABLE_CAPABILITIES} 确定再处理功能是否可用。
402如果设备支持再处理,您可以通过调用
403{@code CameraDevice.createReprocessableCaptureSession()} 创建一个可再处理的相机捕获会话并创建输入缓冲区再处理请求。
404
405</p>
406
407<p>使用 {@code ImageWriter} 类可将输入缓冲区流与相机再处理输入相连。
408如需获得空白缓冲区,请遵循以下编程模型:</p>
409
410<ol>
411<li>调用 {@code ImageWriter.dequeueInputImage()} 方法。</li>
412<li>在输入缓冲区中填充数据。</li>
413<li>通过调用 {@code ImageWriter.queueInputImage()} 方法将缓冲区发送至相机。</li>
414</ol>
415
416<p>如果您将 {@code ImageWriter} 对象与
417{@code android.graphics.ImageFormat.PRIVATE} 图像一起使用,您的应用并不能直接访问图像数据。
418请改为调用 {@code ImageWriter.queueInputImage()} 方法,将 {@code ImageFormat.PRIVATE} 图像直接传递给
419{@code ImageWriter},而无需进行任何缓冲区复制。
420</p>
421
422<p>{@code ImageReader} 类现在支持 {@code android.graphics.ImageFormat.PRIVATE} 格式图像流。
423凭借此支持特性,您的应用可使
424{@code ImageReader} 输出图像保持为循环图像队列,还可选择一个或多个图像并将其发送给
425{@code ImageWriter} 进行相机再处理。</p>
426
427<h2 id="afw">Android for Work 功能</h2>
428<p>本预览版提供了下列用于 Android for Work 的新 API:</p>
429<ul>
430  <li><strong>用于企业所有、单一用途设备的增强型控件</strong>:现在,设备所有者可以通过控制以下设置来改善企业所有、单一用途 (COSU) 设备的管理:
431
432
433  <ul>
434    <li>通过
435{@code DevicePolicyManager.setKeyguardEnabledState()} 方法禁用或重新启用键盘锁。</li>
436    <li>通过
437{@code DevicePolicyManager.setStatusBarEnabledState()} 方法禁用或重新启用状态栏(包括快速设置、通知以及启动 Google Now 的向上划动手势)。
438</li>
439    <li>通过 {@link android.os.UserManager} 常量
440{@code DISALLOW_SAFE_BOOT} 禁用或重新启用安全启动</li>
441    <li>通过
442{@link android.provider.Settings.Global} 常量 {@code STAY_ON_WHILE_PLUGGED_IN} 防止屏幕在插入电源的情况下关闭。</li>
443  </ul>
444  </li>
445  <li><strong>设备所有者静默式安装和卸载应用</strong>:现在,设备所有者可使用 {@link android.content.pm.PackageInstaller}
446 API 在不依赖 Google Play for Work 的情况下静默式安装和卸载应用。
447现在,您可以通过设备所有者配置设备,从而无需用户干预即可获取并安装应用。
448此功能可用于在不激活 Google 帐户的情况下实现信息亭或其他此类设备的一键式配置。
449</li>
450<li><strong>静默式企业证书访问</strong>:现在,当应用调用
451{@link android.security.KeyChain#choosePrivateKeyAlias(android.app.Activity,android.security.KeyChainAliasCallback,java.lang.String[],java.security.Principal[],java.lang.String,int,java.lang.String) choosePrivateKeyAlias()} 时,配置文件所有者或设备所有者可以在系统提示用户选择证书前调用 {@code DeviceAdminReceiver.onChoosePrivateKeyAlias()} 方法,静默式向发出请求的应用提供别名。
452
453
454此功能让您可以在无需用户干预的情况下授予托管应用访问证书的权限。
455</li>
456<li><strong>自动接受系统更新</strong>。现在,设备所有者可以通过
457{@code DevicePolicyManager.setSystemUpdatePolicy()} 设置一个系统更新政策来自动接受系统更新(例如对于信息亭设备),或者推迟更新并在至多 30 天的时间内防止用户获取更新。
458
459此外,管理员还可设置每日必须获取更新的时间窗口,例如在信息亭设备无人使用的时段。
460有可用的系统更新时,系统会检查工作政策控制器应用是否设置了系统更新政策,并相应地执行操作。
461
462
463</li>
464<li>
465<strong>授权证书安装</strong>:配置文件所有者或设备所有者现在可以授权第三方应用调用以下 {@link android.app.admin.DevicePolicyManager} 证书管理 API:
466
467
468<ul>
469  <li>{@link android.app.admin.DevicePolicyManager#getInstalledCaCerts(android.content.ComponentName)
470getInstalledCaCerts()}</li>
471  <li>{@link android.app.admin.DevicePolicyManager#hasCaCertInstalled(android.content.ComponentName,byte[])
472hasCaCertInstalled()}</li>
473  <li>{@link android.app.admin.DevicePolicyManager#installCaCert(android.content.ComponentName,byte[])
474installCaCert()}</li>
475  <li>{@link android.app.admin.DevicePolicyManager#uninstallCaCert(android.content.ComponentName,byte[])
476uninstallCaCert()}</li>
477  <li>{@link android.app.admin.DevicePolicyManager#uninstallAllUserCaCerts(android.content.ComponentName)
478uninstallAllUserCaCerts()}</li>
479  <li>{@link android.app.admin.DevicePolicyManager#installKeyPair(android.content.ComponentName,java.security.PrivateKey,java.security.cert.Certificate,java.lang.String)
480installKeyPair()}</li>
481</ul>
482</li>
483<li><strong>企业恢复出厂设置保护</strong>:现在,配置设备所有者时,您可以通过设置
484{@code DeviceManagerPolicy.EXTRA_PROVISIONING_RESET_PROTECTION_PARAMETERS} 捆绑包配置参数来解锁恢复出厂设置保护 (FRP)。
485在重置设备以解锁 FRP 和配置设备之后,NFC 编程器应用可提供这些参数,而无需事先配置 Google 帐户。
486
487如果您不修改这些参数,FRP 仍然发挥作用,必须使用之前激活的 Google 凭据方可激活设备。
488
489
490<p>此外,通过对 Google Play 服务设置应用限制,设备所有者可以指定用于 FRP 解锁的备用 Google 帐户,以替代在设备上激活的 Google 帐户。
491</p>
492</li>
493<img src="{@docRoot}preview/images/work-profile-screen.png" srcset="{@docRoot}preview/images/work-profile-screen.png 1x, {@docRoot}preview/images/work-profile-screen_2x.png 2x" style="float:right; margin:0 0 10px 20px" width="282" height="476" />
494<li><strong>数据使用情况跟踪</strong>。现在,配置文件所有者或设备所有者可以利用新增的
495{@code android.app.usage.NetworkStatsManager} 方法查询<strong>设置 &gt; 数据使用情况</strong>中显示的数据使用情况统计信息。
496配置文件所有者会被自动授予查询其管理的配置文件相关数据的权限,而设备所有者则被授予对其管理的主要用户使用情况数据的访问权。
497
498</li>
499<li><strong>运行时权限管理</strong>:
500<p>配置文件所有者或设备所有者可以利用
501{@code DevicePolicyManager.setPermissionPolicy()} 设置适用于所有应用全部运行时请求的权限政策,以提示用户照常授予权限,或自动以静默方式授予或拒绝权限。
502
503如果设置后一种政策,则用户将无法修改配置文件所有者或设备所有者在应用权限屏幕的<strong>设置</strong>内所做的选择。
504
505</p></li>
506<li><strong>“设置”中的 VPN</strong>:现在,<strong>设置 &gt; 更多 &gt; VPN</strong> 中会显示 VPN 应用。此外,现在,关于 VPN 使用情况的通知取决于该 VPN 的配置方式。
507
508
509对于配置文件所有者,通知取决于该 VPN 是针对托管配置文件、个人配置文件还是同时针对这两者进行配置。
510对于设备所有者,通知取决于 VPN 是否针对整个设备进行配置。
511</li>
512<li><strong>工作状态通知</strong>:现在,每当来自托管配置文件的应用具有前台活动时,状态栏就会出现一个公文包图标。
513此外,如果设备直接解锁到托管配置文件中某个应用的活动,则会显示一个 Toast,通知用户他们位于托管配置文件内。
514
515
516</li>
517</ul>
518
519<p class="note">
520  如需详细了解 M 开发者预览版中的所有 API 变更,请参阅 <a href="{@docRoot}preview/download.html">API 差异报告</a>。
521</p>
522