York Beta Release Notes

Flash Player 26 and AIR 26 Release Notes

Welcome to Adobe Flash Player 26 and Adobe AIR 26!

Last Updated: July 13, 2017

Welcome to the latest Flash Runtime version 26 beta! We've been hard at work adding new features to Flash Player and AIR and are looking
forward to feedback from our development and Flash Player community.

This beta release includes new features as well as enhancements and bug fixes related to security, stability, performance, and device
compatibility for Flash Player 26 and AIR 26. This document may be updated periodically as more information becomes available.

As always, we appreciate all feedback. We encourage you to post in our beta forums or create bug reports or feature requests on our public bug
database.

Flash Player Beta Forum

AIR Beta Forum
Beta ActionScript reference
Bug Database

NOTES:

The ActiveX Flash Player in this release is not compatible with Windows 8.x or 10
Flash Player for Windows 8.x/10 is available as part of the generally available Windows 8.x/10 update

New and updated features

Disabling Packaging of Shared Android Applications

Starting with AIR 26, packaging of shared applications for Android is disabled. With this change, published applications will always have a captive
copy of the runtime included in their installation package irrespective of the target selected (that is, apk or apk-captive-runtime). This change
allows us to focus our testing and engineering on captive installation - by far, the most popular option.

Moving to WKWebView for StageWebView on iOS

Starting AIR 26, For StageWebView on iOS, we now use WKWebView (instead of UIWebView) behind the scene, which uses WebKit engine to
render WebViews. For more information on WKWebView, see https://developer.apple.com/reference/webkit/wkwebview. This does not impact AS
developers directly. However, because of a few known WebKit bugs, there may be some workflow changes in the existing iOS Apps. Do report
them on Adobe AIR forums for us to investigate.

This change also allows developers to debug StageWebView content in iOS. To enable web inspector on iOS, complete the following steps:

1. Open the Settings app.

2. Tap Safari.
3. Scroll down and select Advanced.
4. Switch Web Inspector to ON.

5. After Web Inspector is enabled, connect your device to your desktop machine with a USB cable. The name of your device appears in the
Develop menu of Safari.
Alternatively, developers can use iOS Simulator to take advantage of Web Inspectors debugging capabilities. Use the same instructions to enable
Web Inspector on iOS, from within the iOS Simulators Settings app.

Apple TV support (Beta Quality)

We have made some enhancements to tvOS support, which was introduced in AIR 24 beta channel. For more information, see the Release Notes
specific to this feature.

DeviceRotation Event Handler for Mobile

When a device is rotated, the orientation of the plane defining device screen changes. This change can be depicted in terms of a Rotation Vector,
which can be represented by Roll-Pitch-Yaw or Quaternions data. The DeviceRotation event handler is used to fetch this data. One scenario
where this data can be useful is to update the viewport of spherical videos when the device is rotated.

This event handler has been introduced in AIR 26, where we have added a new DeviceRotation class which dispatches DeviceRotationEvent
based on the activity detected by the devices motion sensors namely Accelerometer and Gyroscope.

DeviceRotation object

The user can create an object of DeviceRotation class and can access its properties or register for events on this object. For example:

var deviceRotation:DeviceRotation = new DeviceRotation();

DeviceRotation.isSupported returns true if the following conditions are satisfied:

The device has Accelerometer and Gyroscope sensors.

Android devices with versions 4.3(JELLY_BEAN_MR2) and above.
iOS devices with versions 4.0 and above.

DeviceRotationEvent.UPDATE is the event, attached to a DeviceRotation object. The event is used in the following scenarios:

When a new listener function is attached using addEventListener.

When the value of the DeviceRotation vector changes, this event is delivered at some device-determined interval.
When the player may have missed a change in the DeviceRotation (for example, if the player is waking up after sleep), this event is
delivered.

DeviceRotationEvent object

When an update event is fired on the DeviceRotation object, it is caught as a DeviceRotationEvent object. For example:

private function updateHandler(event : DeviceRotationEvent ) : void { }

Properties for DeviceRotationEvent are exposed as:

Timestamp - The duration in milliseconds from the application launch time.

Roll, along Y-Axis - Its unit is Number and the value is an angle in degrees.
Pitch, along X-Axis - Its unit is Number and the value is an angle in degrees.
Yaw, along Z-Axis - Its unit is Number and the value is an angle in degrees.
Quaternion - It is an array that represents the quaternion values in [w, x, y, z] format.

Enhanced Profile
With AIR 26, we are introducing a new stage3D profile Enhanced for AIR Mobile. This will be a new constant in Context3DProfile class.
Availability of "enhanced" profile indicates the availability of AGAL4. The same profile name can be used in requestContext3D and
requestContext3DMatchingProfiles methods of Stage3D.

AGAL 4 introduces a new opcode tld and new Vertex Sampler register vs for fetching texture in a vertex shader. tld is similar to 'tex' opcode
used in the fragment shader. But unlike tex opcode, tld requires a level of detail ( LOD ) value for parameter since GPU does not support the
automatic calculation of LOD in the vertex shader.

Latest version of AGAL is available at https://github.com/adobe-flash/graphicscorelib/tree/master/src/com/adobe/utils

Vertex Texture Fetch

With the introduction of new Stage3D profile i.e. ENHANCED, Vertex Texture Fetch is now available in AIR mobile. Texture Data will be available
in Vertex Shader using AGAL4 and Enhanced profile.

AGAL 4 introduces a new opcode tld and new Vertex Sampler register vs for fetching texture in the vertex shader. tld is similar to 'tex' opcode
used in the fragment shader. But unlike tex opcode, tld requires a level of detail ( LOD ) value as a parameter since GPU does not support the
automatic calculation of LOD in the vertex shader.

tld usage:

tld dst, src, sampler

dst: a destination register for the sampler texture pixel

src: a register containing texture coordinate where the pixel is sampled and containing a level of detail indication as an index of mipmap to use.

The XY components of the src register: a texture coordinate where a texture pixel is sampled. The z component will be used for indicating the side
of the cube map texture if the vertex texture is a cube map.

The w component of the src register: an index of mipmap to use, with a value range from 0 to n-1 where n is the total number of the mipmaps.
The zero index indicates a mipmap in the highest resolution. The fractional part of src.w is how much a selected mipmap would be interpolated
with the next level of the mipmap in lower resolution based on the mipmap filter (mipnearest or miplinear) passed in the shader or set from the
setSamplerStateAt() API. Mipnearest uses nearest-neighbor mipmap, while miplinear uses linearly filtered mipmapping.

vertex sampler vs

tld vt0, va0, vs0<2d,linear,miplinear>

The above example code fetches texture pixels from the texture bound to vertex sampler 0 (vs0) to a vertex temporary register 0 (vt0) with a
texture coordinate provided in a vertex attribute register 0 (va0) and a sampler state(< 2d, linear, miplinear >) provided in the vertex shader. The
LOD value is provided in va0.w in the example.

A total number of vertex samplers available will be 4. The sum of vertex and fragment samplers is restricted to 16.

Please note that tld opcode cannot be used inside fragment sampler.

To provide a texture for a vertex sampler in the vertex shader, developers should use existing ActionScript API, SetTextureAt().

SetTextureAT(0, texture);

The above example code binds 'texture' to the vertex sampler 0 (vs0). Note that this call would set up 'texture' to the fragment sampler in the
same index, which is the fragment sampler 0 (fs0), if there is access to fs0 in the fragment shader.

A sampler state of the vertex sampler in the vertex shader code could be overridden with the existing AS API, SetSamplerStateAt:

SetSamplerStateAt(0, Context3DWrapMode.CLAMP, Context3DTextureFilter.LINEAR, Context3DMipFilter.MIPNEAREST

);

Like the SetTextureAt API, the above call would also set up the state of the fragment sampler in the same index, which is the fragment sampler 0
(fs0), if fs0 is used in the fragment shader.

Please note, Anisotropic Filtering is not available for texture sampling used in vertex shaders.

Vertex Texture Fetch feature is useful for a number of effects like displacement mapping, water simulation, and explosion mapping etc.

Runtime Versions

Flash Player: 26.0.0.138

AIR Runtime: 26.0.0.119

AIR SDK & Compiler: 26.0.0.119

Known Issues

July 13, 2017

Flash Player

Graphics vector assets are not rendering properly.(FP-4198401).

AIR

NA

June 22, 2017

Flash Player

2.5D rotation is not working as expected on Windows and Mac Chrome (FP-4198483)
FileReference size and creationDate throws IO Error (FP-4198443)

AIR

[iOS]"Error #3672: Buffer creation failed" is observed on Starling when render to texture is used with anti-aliasing.(AIR-4198370)

June 14, 2017

Flash Player

UI does not respond to button clicks for https://discoveryacademy.rhdiscovery.com/ (FP-4198473)

Masking of object prevents the click operation for underneath objects (FP-4198471)

AIR

N/A

June 8, 2017

Flash Player

N/A

AIR

N/A

May 24, 2017

Flash Player

N/A

AIR

N/A

May 17, 2017

Flash Player

removeMovieClip() method is not working as expected.(FP-4198400)

AIR

[iOS] StageWebView not loading local HTML

May 10, 2017

Flash Player

N/A

AIR

Using same texture for fragment and vertex sample does not render the object when same sampler state is defined for both fragment and
vertex shader (4187904)

May 03, 2017

Flash Player

N/A

AIR

N/A

April 27, 2017

Flash Player

N/A

AIR

[Android] 'Texture decoding failed' error is displayed when uploading the texture asynchronously (AIR-4198272)
[Android] StageText does not fire the ENTER event (AIR-4198260)
[iOS] Compilation fails while executing: compile-abc - class (...) could not be found (AIR-4198225)
[Android] Launcher icons are packaged in incorrect resources location (AIR-4198222)
[iOS] Interfaces do not function when shared between SWFs (AIR-4194914)
[iOS] Starling masking does not work on iOS with anti-aliasing turned ON (AIR-4198229)

Fixed Issues
July 13, 2017

Flash Player

NA

AIR

NA

June 22, 2017

Flash Player

Flex Application fails to trigger drag and drop events.(FP-4198474)

UI does not respond to button clicks for https://discoveryacademy.rhdiscovery.com/ (FP-4198473)
Masking of object prevents the click operation for underneath objects (FP-4198471)
Unable to select different dropdown on mis-architecture.co.uk(4187758)
https://play.alphapengu.in/ does not respond to button click(4188159)

AIR

Flex DragManger is not working on masked object in AIR applications(4188202)

Drag and drop is not working as expected with AIR runtime 26(AIR-4198378, AIR-4198374, AIR-4198376, AIR-4198375, AIR-4198373)

June 14, 2017

Flash Player

"Play as Guest" button is not working for miniclip.com 8 Ball Pool game (4188158)

AIR

N/A

June 8, 2017

Flash Player

FileReference size and creationDate throws IO Error (FP-4198443)

AIR

N/A

May 24, 2017

Flash Player

removeMovieClip() method is not working as expected(FP-4198425,FP-4198400)

http://catalog.kaientai.cc viewer application quits unexpectedly. (FP-4198403)

AIR

[iOS] drawViewPortToBitmapData method on StageWebView return an empty bitmapdata

[iOS] AudioPlaybackMode.VOICE and SoundMixer.useSpeakerphoneForVoice = true not working with bluetooth headset (AIR-4196360)

May 17, 2017

Flash Player

Video quits unexpectedly while playing from http://tw.youvivid.com/preview_showcase.asp (FP-4198402)

Flash Player quits unexpectedly upon interaction with site tabs(FP-4198407)
[Mac]EncryptedLocalStore API throws Error:EncryptedLocalStore Internal error (4187974)

AIR

Starling masking is not working on iOS with Anti-Aliasing ON (AIR-4198229)

[Android] StageText not firing ENTER event (AIR-4198260)

May 10, 2017

Flash Player

Application quits unexpectedly and no audio/ video is observed for FP Beta 26.0.0.89 and 26.0.0.94 (FP-4198395)

AIR

N/A

May 03, 2017

Flash Player

N/A

AIR

"Could not generate timestamp: Connection error" is displayed while packaging the AIR application (AIR-4195221, AIR-4198332,
AIR-4172255)

April 27, 2017

Flash Player

N/A

AIR

[iOS] Unable to launch iPad Pro on iOS Simulator from ADT (AIR-4198314)
[iOS] AudioPlaybackMode.Voice not working with Bluetooth headset (AIR-4196360)

Authoring for Flash Player 26 and AIR 26

Update application descriptor namespace to 26

SWF version should be 37

System Requirements
For system requirements of the current release of Flash Player in production, visit http://www.adobe.com/products/flashplayer/systemreqs/
For system requirements of the current release of AIR in production, visit http://www.adobe.com/products/air/systemreqs/