发行说明 | 开发人员 | Flash Player 11.3、AIR 3.3

2012 年 6 月 8 日。欢迎使用 Adobe® Flash Player® 11.3 和 AIR® 3.3。此发行版本包括与稳定性、性能和设备兼容性相关的主要功能、增强和错误修补程序。

• Flash Player 台式机版 11.3.300.257
• AIR 台式机版 3.3.0.3650
  
• AIR Android^TM 3.3.0.3650
• AIR SDK 3.3.0.3650
  

台式机版：

• 适用于 Flash Player 的全屏键盘输入
• 通过 NetStream 对流式音频的低延迟音频支持
• 对 Sound API 的低延迟音频支持
• Firefox 的保护模式（仅限 Windows®）
• 纹理流式处理
• Mac 的后台更新程序
• Framelabel 事件
• Bitmapdata.drawwithQuality
• bitmapData.encode
• ReleaseOutside 事件
• Runtime 类自检
• 改进了 Apple MacOS 应用商店支持

AIR 移动设备版：

• 在 Windows 上提供对 iOS 的 Platform SDK 支持
• 对 Android^TM 4.0 设备的触笔支持
• 适用于 AIR iOS 的 USB 调试
• 适用于 AIR iOS 的增强后台行为
• 适用于 iOS 的模拟器支持
• 纵横比增强功能

适用于 Flash Player 的全屏键盘输入
开发人员可以调用 StageDisplayState.FULL_SCREEN_INTERACTIVE 来在 Flash Player 中启用完全支持所有键盘键的全屏模式。最终用户会看到一个许可对话框并可以允许 SWF 内容接收键盘输入，也可以点击“Esc”退出新模式。API 允许开发人员确定应用程序是否处于全屏模式，用户是否已允许完全键盘输入，以及应用程序是否能够请求全屏，这由 HTML 嵌入标签参数决定。

对流式音频的低延迟音频支持
引入了一个新的 NetStream.useJitterBuffer API，开发人员可使用它缩短高品质流式音频播放的延迟。

对 Sound API 的低延迟音频支持
此增强功能缩短了 Sound.play 方法的延迟并减少了对 SoundTransform 上的音量和声相的更改。同时还大大缩短了 SAMPLE_DATA 事件的延迟。如果输入样本大小为 2048，则延迟应是最佳的。

Firefox 的保护模式
Flash Player 保护模式是新增的安全性增强功能，旨在限制从恶意 SWF 文件启动的攻击对在 Windows Vista® 和更高版本 Windows 上的 Firefox 4.0+ 中运行的 Adobe Flash Player 的影响。此功能类似于 Google Chrome 浏览器中的 Flash Player 保护模式、Adobe® Reader® 中的保护模式和 Office 2010 受保护的视图。默认情况下，每次在 Firefox 中查看 Flash Player 文件时将启用保护模式，从而减少持久恶意软件对客户端系统的潜在安全威胁风险。在启用保护模式后，Flash Player 文件将显示在称为“沙箱”的受限制环境中。保护模式沙箱可能引起与 Web 上的现有 Flash 内容的兼容问题。保护模式是保护您和您的计算机免遭恶意 SWF 文件攻击的安全性增强功能。Adobe 建议始终启用保护模式。

纹理流式处理
纹理流式处理是 Stage3D 的一项新功能，用于首先加载较粗、较低品质的纹理，然后在有更多数据可用时逐渐改进这些纹理。

适用于 Mac 的后台更新程序
Adobe 在 Flash Player 11.2 中引入了后台更新程序功能，以便根据用户选择、安全更新和针对 Windows® 的错误修补程序来自动安装可用更新。这一功能现在可以在 Mac 上的 Flash Player 11.3 中使用

在 Windows 上提供对 iOS 的 Platform SDK 支持
现在，开发人员可以在 Windows® 计算机上复制 iOS SDK 文件夹，还可以在 Windows® 上使用 adt 的 platformsdk 选项。

adt –package –target (ipa-app-store|ipa-ad-hoc|ipa-debug|ipa-debug-interpreter|ipa-test|ipa-test-interpreter) -platformsdk

此功能目前在 Flash Builder 中尚未提供。应正确复制 SDK，即应将 iOS SDK 中的符号链接转换为 Windows® 上的实际文件，否则，打包将失败。

对 Android^TM 4.0 的触笔支持
Flash Player 增加了对 Android 4.0 中引入的新 Android^TM Stylus API 的支持。触笔感知应用程序将自动用于支持 Stylus API 的设备

适用于 AIR iOS 的 USB 调试
开发人员现在可以在 Mac 和 Windows 系统上通过 USB 调试 iOS 设备上的 AIR 应用程序。在此版本之前，开发人员必须使用 wifi 来调试 iOS 设备上的 AIR 应用程序。不过，存在一些与 wifi 调试相关的限制

a) 开发人员必须始终能够连接到 Internet
b) 设备和台式机需要位于同一子网中

此新功能将解决上面提到的问题，并且能够通过将 iOS 设备连接到 Mac 或 Windows® 计算机为用户提供无缝调试体验。

适用于 AIR iOS 的增强的后台行为
iOS 上的 AIR 应用程序现在支持在后台运行时进行位置更新和联网。在后台应用程序由操作系统挂起之前，还将通知应用程序。

模拟器支持 (Mac)
为 iOS 创建 AIR 应用程序的开发人员现在可以使用 Xcode 在 iOS 模拟器上打包和运行应用程序

纵横比增强功能
iOS 上的 AIR 3.3 会适当考虑应用程序的指定纵横比。以相对于指定纵横比的旋转角度来表示方向。

FrameLabel 事件
在播放指针进入新帧时发送新的 Event.FRAME_LABEL 事件，该帧的 FrameLabel 具有为此事件注册的侦听器。如果播放指针没有移动或者只有一个帧，将向 FrameLabel 事件侦听器不断发送此事件与帧速率。这简化了时间轴脚本。

BitmapData.drawWithQuality
过去，必须修改阶段品质才能更改 BitmapData.draw 的品质。BitmapData.drawWithQuality 是 BitmapData.draw 的扩展，用于添加指定矢量渲染质量的可选参数。

BitmapData.encode
BitmapData.encode 允许将 BitmapData 对象本机压缩为 PNG、JPEG 和 JPEG XR。这将使开发人员获得在移动设备中非常有用的、进行运行时图像压缩所需的本机速度。

ReleaseOutside 事件
我们再次引入了 releaseOutside 鼠标事件。现在可重新使用在 AS3 中删除的这一事件。

示例：

1.s.addEventListener(MouseEvent.RELEASE_OUTSIDE, onReleaseOutsideHandler);

Runtime 类自检
对 Application.getDefinition() 的限制是，您必须提前知道要提取的类定义的名称。现在，applicationDomain.getQualifiedDefinitionNames() 可提取 SWF 中的所有可用类，非常适用于 SWF 自检和运行时已加载资源。

Adobe Flash Player 台式机版 11.3.300.255 和 AIR 3.3.0.3610 包括安全公告 APSB12-14 中介绍的安全修补程序。

• [Stage3D] 在台式机版上，Starling 内容渲染在错误的位置 (3153467)
  
• 在使用 GPU 渲染模式时，iOS 渲染在一些应用程序上冻结了 (3124838)
• 现在在 renderMode=gpu 模式中考虑抗锯齿质量设置 (3124862)
• [Stage3D] 在具有 Intel HD 3000 的 Mac 上，没有正确设置裁剪矩形 (2959500)
• 在 Windows® 7 上 Chrome 浏览器中使用 MouseLock 时，movementX/Y 返回绝对值而非相对值 (3152175)
• 在浏览器中打开 Flash Player 的多个实例时，出现音频延迟问题 (3084306)
• 视频播放存在绿屏问题 (3050372)
  

Flash Player 台式机版

• Mac OS：当鼠标置于 TLF 链接上方时光标不会变为手形指针 (3060839)
• Mac OS：新型 Apple 计算机运行 10.7.2 时，Adobe AIR 崩溃（在此处查看解决方法）
• 处于全屏模式时，MouseLock 和 FullscreenSourceRect 不会更新显示 (3006724)
• Nvidia 硬件驱动程序：要利用硬件解码，Nvidia 用户需要将其驱动程序更新为 285.79 或更高版本，否则 Flash Player 将使用软件解码 (3160326)

Android^TM

• 在视频暂停时进行搜寻不会更新 Android^TM 4.0 设备上的帧 (2995654)
• 在 Adobe AIR 上，使用 On2 和 Sorenson 的 StageVideo 在 Android 4.0 设备上不工作 (3053819)
  
• 在去掉 context3D 对象并请求新对象或返回到后台应用程序后，Context3d 将为一些帧渲染黑色。(3019048)
  

要使用新的 Flash Player，需要通过将一个额外的编译器参数传递给 Flex 编译器 (-swf-version=16)，来将 SWF 版本指定为 16。请参见下文中的说明。
如果正在使用 Adobe Flex SDK：

• 请下载用于 Flash Player 11.3 的新 playerglobal.swc
• 从 Flex 4.5 SDK 表中下载 Flex 4.5.1 SDK (4.5.1.21328)。
• 在 Flash Builder 中，创建一个新的 ActionScript 项目：“文件”->“新建”->“ActionScript 项目”。
• 打开项目的“属性”面板（单击鼠标右键，然后选择“属性”）。从左侧列表中选择“ActionScript 编译器”。
• 使用右上角的“配置 Flex SDK”选项将项目指向 Flex 版本 21328。单击“确定”。
• 配置项目，将 SWF 版本指定为 16
• 将 -swf-version=16 添加到“附加编译器参数”输入中。这样可确保输出的 SWF 将以 SWF 版本 16 为目标。如果您在命令行而不是在 Flash Builder 中进行编译，则需要添加相同的编译器参数。
• 请确保在浏览器中安装了新的 Flash Player 11.3 版本。

更新到 AIR 3.3 命名空间
要访问新的 AIR 3.3 API 和行为，必须将应用程序描述符文件更新到 3.3 命名空间。如果您的应用程序不需要使用新的 AIR 3.3 API 和行为，则不需要更新命名空间。但是，即使您尚未利用新的 3.3 功能，我们也建议所有用户着手使用 AIR 3.3 命名空间。要更新命名空间，请将应用程序描述符中的 xmlns 属性更改为：

全屏键盘输入
要启用使用键的全屏模式，必须将新的 / 标签参数 allowFullScreenInteractive 添加到包含 HTML 中。此参数默认为 false，即不允许使用键的全屏模式。要允许使用键的全屏模式，请在您的标签中将 allowFullScreenInteractive 设置为“true”，如下所示：

在 mms.cfg 中，通过设置 FullScreenInteractiveDisable = 1，可以禁用此功能，如下所示：

相关的 ActionScript API：
flash.display.Stage.getAllowsFullScreenInteractive();
flash.display.StageDisplayState
flash.events.FullScreenEvent

纹理流式处理
纹理流式处理是 Stage3D 的一项新功能，用于首先加载较粗、较低品质的纹理，然后在有更多数据可用时逐渐改进这些纹理。

function createCubeTexture( size:int, format:String, optimizeForRenderToTexture:Boolean, streamingLevels:int=0):CubeTexture
function createTexture( width:int, height:int, format:String, optimizeForRenderToTexture:Boolean, streamingLevels:int=0 ):Texture;

已将其他可选参数 streamingLevels 添加到 Context3D::createTexture 和 Context3D::createCubeTexture 函数中。
如果此参数为非 0 值，将对此纹理进行流式处理。对于二维纹理，最大值为 log2(max(width, height))；对于立方图纹理，最大值为 log2(size)。更大的值将使纹理创建失败，并出现操作脚本错误。进行流式处理的纹理无法用于渲染到纹理，并且将忽略其 optimizeForRenderToTexture 标志。进行流式处理的纹理具有最大附加大小为 50% 的潜在内存使用率损失和潜在上传速度损失。在完全加载纹理后，无法使用其他内容再次对其进行流式处理。如果纹理标记为流式处理，则将它视为完整的并且可以在上传高于或等于 streamingLevels 值的所有 mip 级别后进行渲染。纹理上传不变。
示例：

BitmapData.drawWithQuality
过去，必须修改阶段质量才能更改 BitmapData.draw 的质量。BitmapData.drawWithQuality 是 BitmapData.draw 的扩展，用于添加指定矢量渲染质量的可选参数。
function drawWithQuality(source: IBitmapDrawable, matrix:Matrix=null, colorTransform: ColorTransform =null, blendMode:String=null, clipRect:Rectangle=null, smoothing:Boolean=false, quality:String=null): void

下面是受支持的质量值：

StageQuality .LOW、StageQuality .MEDIUM、StageQuality.BEST、StageQuality .HIGH_8X8_LINEAR、StageQuality .HIGH_16X16、StageQuality .HIGH_16X16_LINEAR

BitmapData.encode
BitmapData.encode 允许将 BitmapData 对象本机压缩为 PNG、JPEG 和 JPEG XR。这将使开发人员获得运行时图像压缩所需的本机速度，这在移动设备中非常有价值。
function encode(rect:Rectangle,EncoderOptions :Object, byteArray: ByteArray = null): ByteArray;

受支持的 EncoderOptions 对象如下所示：

JPEGXREncoderOptions (quantization:uint=20,colorSpace:String="auto", trimFlexBits:uint=0)
JPEGEncoderOptions(quality:uint=80, colorSpace:String="auto")
PNGEncoderOptions()

示例：

Context3D.driverinfo 中的 HW 失败字符串
此功能在 Stage3D 内容无法硬件加速时提供 Context3D.driverInfo 中的信息。Context3D.driverInfo 将包括以下字符串之一，即 Stage3D 为什么回退到软件。
1. Software Hw_disabled=userDisabled：“设置”UI 中的 HW 加速设置复选框处于禁用状态，将使用软件渲染 Stage3D。
2. “Software Hw_disabled=oldDriver”：HW 图形驱动程序由于已知问题被列入黑名单，将使用软件渲染 Stage3D。将通过更新驱动程序解决此问题。
3. “Software Hw_disabled=unavailable”：由于驱动程序的功能或通常位于黑名单中或 HW 图形初始化失败，无法使用硬件渲染，将使用软件渲染 Stage3D。
4. “Software Hw_disabled=explicit”：内容通过 requestContext3D 显式请求软件渲染，将使用软件渲染 Stage3D

纵横比增强功能
在 AIR 3.3 中，解决了忽略指定纵横比的运行时问题。如果设置了 aspectRatio 并且 autoOrients 为 true，阶段方向将仅局限于设备旋转的两个方向（根据纵横比的值，应支持横向-左和横向-右方向或者纵向和纵向倒置方向）。

已添加名为 ANY 的新 StageAspectRatio 常量。StageAspectRatio.ANY 可用于在 autoOrients 设置为 true 的所有设备方向中实现自动阶段方向。在应用程序描述符中缺少 aspectRatio 标签时，这将是默认行为。

适用于 AIR iOS 的 USB 调试
首先，使用额外的 -listen 开关打包应用程序，以确保应用程序在启动时侦听 fdb 连接。

adt -package -target (ipa-debug-interpreter | ipa-debug) -listen (port number optional) -provisioning-profile xyz.mobileprovision -storetype pkcs12 -keystore Certificates.p12 -storepass pass123 OutputFile.ipa InputFile-app.xml InputFile.swf

默认情况下，应用程序会侦听端口 7936。用户可以指定任何所选端口。

adt -package -target (ipa-debug-interpreter | ipa-debug) -listen 16000 xyz.mobileprovision -storetype pkcs12 -keystore Certificates.p12 -storepass pass123 OutputFile.ipa InputFile-app.xml InputFile.swf

2) 在将应用程序打包为 ipa 后，在设备上安装并启动它。

3) 运行 idb 二进制可用的、带 -devices 参数的 @ SDK_LOCATION/lib/aot/idb。它将返回附加到台式机的设备的列表及其 DEVICE_HANDLES。

idb -devices

4) 现在，需要将台式机的某个端口转移到侦听连接的设备的端口。

idb -forward LOCAL_PORT REMOTE_PORT DEVICE_HANDLE

此·LOCAL_PORT 是指台式机上的端口。它可以是您优先选择的大于 8000 的任何端口号。

REMORT_PORT 是您在打包命令中提到的端口号。如果您在打包时没有提到任何端口号，则默认情况下，您的应用程序将侦听端口 7936。

您的设备的 DEVICE_HANDLE 是从步骤 3 中获得的。

5) 现在，使用以下命令启动 fdb。

fdb -p LOCAL_PORT

6) 它将启动 fdb 调试器。在命令行中键入“r”来启动调试会话。

注意：idb 提供了另一个用于停止端口转移的名为“stopforward”的参数。不过，它仅在 fdb 会话尚未建立之前可用。

idb -stopforward LOCAL_PORT

此功能目前在 Flash Builder 中尚未提供。

适用于 AIR iOS 的增强后台行为
后台支持现在更加类似于 iOS 中的本机应用程序。除了已为 AIR for iOS 启用的一些基本多任务和后台音频支持外，应用程序现在还支持在后台进行位置更新和联网，以及在后台应用程序即将由操作系统挂起时获得通知。
为此，添加了几个新标签和一个事件。要支持在后台进行位置更新，应在 AIR 应用程序描述符的 iPhone 标签中包括以下内容：

如果您的应用程序指定此标签并转到后台，则播放器将继续以 4fps 运行。不过，将禁用所有屏幕更新（渲染调用、OpenGL 调用）。
如果您的应用程序需要同时生成音频并跟踪位置（例如对于 Turn by Turn 导航应用程序），UIBackgroundModes 项将同时支持“位置”和“音频”。
iOS 提供运行短期后台任务的机制。不过，iOS 不保证将执行该任务，而只是代表用户延长作业处于处理状态的时间。此类后台任务可使应用程序一定时间内保持运行状态，这个时间限制最大为约 10 分钟。

如果应用程序编写器将属性 executeInBackground 指定为 TRUE/FALSE，那么将选取该值，并且应用程序将相应运行。目前，当应用程序转入后台时，将触发 Deactivate 事件，而不管应用程序是否已挂起。为向应用程序提供更多特定信息，将在应用程序即将挂起时将 Suspend 事件发送到应用程序，以支持适当的应用程序行为。
在 iOS 上，为延长电池寿命，当应用程序选择在后台执行时，播放器速度将调低为 4fps。

模拟器支持
因为 iOS 上的模拟器是 x86，所以在 ADT 中为它添加了两个新目标。请注意，仅支持以解释器模式打包模拟器。

目标是：

1.) ipa-test-interpreter-simulator
2.) ipa-debug-interpreter-simulator

要开始在模拟器上测试您的应用程序，无需从 Apple 获取开发人员证书（这需要花大量时间），或者在开始开发 AIR 应用程序之前创建部署配置文件（用户只需要一个自己创建的 p12 证书即可）。

要为模拟器打包应用程序，请执行以下命令。

解释器目标

adt -package -target ipa-test-interpreter-simulator -storetype pkcs12 -keystore Certificates.p12 -storepass password Sample_ipa_name sample_ipa-app.xml sample_ipa.swf

调试目标

adt -package -target ipa-debug-interpreter-simulator -storetype pkcs12 -keystore Certificates.p12 -storepass password Sample_ipa_name sample_ipa-app.xml sample_ipa.swf

*在模拟器中安装应用程序*

adt -installApp -platform ios -platformsdk (sdk 的路径，例如 /Developer/Platforms/iPhoneSimulator.platform/Developer/SDKs/iPhoneSimulator5.0.sdk) -device ios-simulator -package Sample_ipa_name.ipa

*在模拟器中启动应用程序*

adt -launchApp -platform ios -platformsdk (sdk 的路径，例如 /Developer/Platforms/iPhoneSimulator.platform/Developer/SDKs/iPhoneSimulator5.0.sdk) -device ios-simulator -appid

Sample_ipa_name

为在模拟器上测试本机扩展，已在 extension.xml 中添加了新平台名称 (iPhone-x86) 支持
请注意，用于打包本机扩展的所有命令将保持相同，但只应为模拟器编译 XCode 中的所需 library.a 文件

extension.xml 如下所示

有关最新 Flash Player 系统要求，请访问 http://www.adobe.com/cn/products/flashplayer/systemreqs/。

有关最新 AIR 系统要求，请访问 http://www.adobe.com/cn/products/air/systemreqs/。

有关 Flash Access 系统要求（客户端和服务器），请访问 http://www.adobe.com/products/flashaccess/systemreqs/。

Flash Player 11.3 具有以下最低系统要求：

AIR 3.3 具有以下最低系统要求：

发现了程序错误？请将错误报告提交到 Flash Player 和 Adobe AIR 错误数据库。

Flash Player 和 AIR 可利用您的图形硬件解码和播放 H.264 视频。有些视频问题可能只能用特殊图形硬件和驱动程序才会重现。当报告有问题的视频时，必须记下您的图形硬件和驱动程序，以及操作系统和浏览器（当使用 Flash Player 时），以便我们可以重现和调查问题。请确保按有关报告视频播放问题的说明中的要求，包含这些信息。注意：我们会收到大量电子邮件，所以无法答复所有的请求。

感谢您使用 Adobe® Flash Player® 和 AIR®，并抽出宝贵时间向我们提供反馈！