VO Player 08.

05 Android
Release Notes
Product version
Copyright
The contents of this documentation are strictly confidential and the receiver is obliged to use them
exclusively for his or her own purposes as defined in the contractual relationship. No part of Viaccess‐Orca
applications or this document may be reproduced or transmitted in any form or by any means, electronic or
mechanical, including photocopying, recording, or by any information storage and retrieval system, without
permission in writing from Viaccess S.A and/or Orca Interactive.

The information in this document is subject to change without notice. Viaccess S.A nor Orca Interactive
warrant that this document is error free. If you find any problems with this documentation or wish to make
comments, please report them to Viaccess‐Orca in writing at documentation@viaccess‐orca.com.

Trademarks
Viaccess‐Orca is a trademark of Viaccess S.A ® in France and/or other countries. All other product and
company names mentioned herein are the trademarks of their respective owners.

Viaccess S.A and or Orca Interactive may hold patents, patent applications, trademarks, copyrights or other
intellectual property rights over the product described in this document. Unless expressly specified
otherwise in a written license agreement, the delivery of this document does not imply the concession of
any license over these patents, trademarks, copyrights or other intellectual property.

Document reference number: 24841

Document version number: 1.0 Release

© 2019 Viaccess‐Orca
 VO Player 08.05 Android Release Notes
Table of Contents
VO Player 08.05

Table of Contents

Release overview .............................................................................................................................................. 2  

rd
VO Player 08.05.07 - May 3 2019 ................................................................................................................ 2  

VO Player 08.05.06 - April 19th 2019.............................................................................................................. 3  

th
VO Player 08.05.05 - April 5 2019................................................................................................................ 4  

VO Player 08.05.04 - March 22nd 2019 .......................................................................................................... 5  

th
VO Player 08.05.03 - March 8 2019 ............................................................................................................ 6  

nd
VO Player 08.05.02 - February 22 2019 ...................................................................................................... 7  

VO Player 08.05.01 - February 07th 2019 ...................................................................................................... 9  

th
VO Player 08.05.00 - January 30 2019 ...................................................................................................... 10  

Release details ................................................................................................................................................ 12

 

Features ...................................................................................................................................................... 12
 

Known SDK limitations ................................................................................................................................ 12  

Dash offline viewing ................................................................................................................................ 12  

VMAP post-roll "Skip Advertisement" .................................................................................................... 12  

AudioBooster with advertisements ........................................................................................................ 12  

Subtitles .................................................................................................................................................. 12
 

Chromecast ............................................................................................................................................ 13 

Scrubbing ................................................................................................................................................ 13
 

Widevine ................................................................................................................................................ 13
 

API updates.................................................................................................................................................. 13
 

Patch release notes keywords ........................................................................................................................ 14  

Delivery Package .............................................................................................................................................. 16 

This document is Viaccess SA or Orca Interactive intellectual property. 1

Copying is strictly forbidden.
Confidential ‐ under NDA
 VO Player 08.05 Android Release Notes
Release overview
VO Player 08.05

Release overview

VO Player 08.05.07 - May 3rd 2019

Type Severity Tags & description
CHANGES HIGH • N/A

MEDIUM • N/A

LOW • Specific cases of under attack errors are now reported as rooted errors.
[SECURITY]

BUGFIXES HIGH • N/A

MEDIUM • Fix crash when the reset and prepare functions are called quickly.
[SCRUBBING]

• Fix possible crash when using platform audio decoder.

[AUDIO]

LOW • N/A

This document is Viaccess SA or Orca Interactive intellectual property. 2

Copying is strictly forbidden.
Confidential ‐ under NDA
 VO Player 08.05 Android Release Notes
Release overview
VO Player 08.05

VO Player 08.05.06 - April 19th 2019

Type Severity Tags & description
CHANGES HIGH • N/A

MEDIUM • Robustness on background/foreground management with Widevine

content.
[WIDEVINE]

LOW • N/A

BUGFIXES HIGH • Fix crash when using Audio platform decoder after multiple seeks on legacy
devices.
[AUDIO]

MEDIUM • Fix for specific WebVTT subtitles not being displayed.

[SUBTITLE (WEBVTT)]

• Fix error when PeriodID name changes during a manifest update.

[DASH]

• Fix crash when end of start-over stream is reached.

[DASH] [START_OVER]

• Fix root-detection for specific rooted devices.

[SECURITY]

LOW • Fix for license expiration not detected properly on some old devices.
[WIDEVINE]

• Fix unexpected infinite opening instead of raising an error if no alternate

can be played.
[HLS]

• Fix for infinite GetRightsInfo call when the license is expired on Android
5.x.
[WIDEVINE]

This document is Viaccess SA or Orca Interactive intellectual property. 3

Copying is strictly forbidden.
Confidential ‐ under NDA
 VO Player 08.05 Android Release Notes
Release overview
VO Player 08.05

VO Player 08.05.05 - April 5th 2019

Type Severity Tags & description
CHANGES HIGH • N/A

MEDIUM • Set license request connection timeout to 30s.

[WIDEVINE]

LOW • Extends error code returned regarding Widevine License Acquisition request
status. New error code handled are
MEDIA_ERROR_DRM_NETWORK_COMMUNICATION_FAILURE and
MEDIA_ERROR_DRM_SERVER_NOT_REACHABLE.
[WIDEVINE]

BUGFIXES HIGH • N/A

MEDIUM • Fix race condition causing manifest not to be refreshed anymore.

[CORE]

• Fix crash when parsing mpd files with specific playready encryption syntax.
[DASH] [PLAYREADY]

• Robustness on STOV management with DASH protocol.

[START_OVER] [DASH]

• Fix possible video corruption when app is back to foreground.

[WIDEVINE]

• Fix crash on concurrent license decryption (linked to getUniqueIdentifier()

API usage).
[CORE]

• Fix issue on some devices when player performs padding on the

surfaceView while the application is in background.
[CORE]

LOW • Fix unexpected infinite opening instead of raising an error if no alternate

can be played.
[HLS]

This document is Viaccess SA or Orca Interactive intellectual property. 4

Copying is strictly forbidden.
Confidential ‐ under NDA
 VO Player 08.05 Android Release Notes
Release overview
VO Player 08.05

VO Player 08.05.04 - March 22nd 2019

Type Severity Tags & description
CHANGES HIGH • N/A

MEDIUM • N/A

LOW • New error code MEDIA_ERROR_DRM_LICENSE_NOT_FOUND (3112) when

the key has not been found in loaded license. Note that the license will be
automatically deleted when this error occurs.
[WIDEVINE]

• Fix javadoc issues about deprecated onInfoListener API and broken inner
links.
[DOC]

• Adding 3GP_READER module to debug log system.

[DEBUG]

• Sending Downloader networks events

(DOWNLOADER_INFO_NETWORK_DOWN/DOWNLOADER_INFO_NETWORK_BA
CK) only once in a row.
[DOWNLOAD]

BUGFIXES HIGH • Fix green bar at the top of video surface on some high-end devices.
[CORE]

MEDIUM • Fix player reset on alternate change on ByteRange advertisement streams.

[ADS]

• Fix potential Audio/Video sync issue after audio track change with platform
audio decoder.
[AUDIO]

• Fix audio frequency glitch when using platform audio decoder.

[AUDIO]

LOW • Fix possible crash in HTTP stack on specific streams.

[CORE]

• Fix playback error that randomly happens when jumping to the end of mp4
file.
[MP4]

• Return MEDIA_ERROR_NETWORK_BAD_URL if URL format is not recognized

as supported.
[CORE]

This document is Viaccess SA or Orca Interactive intellectual property. 5

Copying is strictly forbidden.
Confidential ‐ under NDA
 VO Player 08.05 Android Release Notes
Release overview
VO Player 08.05

VO Player 08.05.03 - March 8th 2019

Type Severity Tags & description
CHANGES HIGH • N/A

MEDIUM • Allowing SRB and SCB license flags work independently with PlayReady
streams.
[SECURITY]

• Add setHttpStreamingAbrControlSettings API. For now it can only be used

to set max buffer level in seconds (allowed range is 20-300s). Note that
setting this value will override the settings of any setCustomMode call.
[API]

LOW • Unifying error codes when trying to play streams with unsupported DRM
schemes. Expected error code in this case is 3101
(MEDIA_ERROR_DRM_NOT_SUPPORTED).
[CORE]

• Introducing new error code MEDIA_ERROR_DRM_LICENSE_EXPIRED (3111)

when the license expires during playback.
[WIDEVINE]

BUGFIXES HIGH • N/A

MEDIUM • Fix license acquisition renewal when persistent license has expired.
[WIDEVINE]

• Parse Dash stream with url without characters ".mpd".

[ADS]

LOW • Return "MEDIA_INFO_NETWORK_NO_FILE" instead of

"MEDIA_ERROR_ILLEGAL_STATE" if file not found.
[CORE]

This document is Viaccess SA or Orca Interactive intellectual property. 6

Copying is strictly forbidden.
Confidential ‐ under NDA
 VO Player 08.05 Android Release Notes
Release overview
VO Player 08.05

VO Player 08.05.02 - February 22nd 2019

Type Severity Tags & description
CHANGES HIGH • Add support of AndroidX dependency management.
[CORE] [BUILD]

MEDIUM • Start-Over playlists are now supported with DASH streams. Mode shall
however be forced via setHttpStreamingEventPlaylistEnabled API.
[DASH]

LOW • Javadoc on onInfo related APIs was not properly stating those as
deprecated.
[DOC]

• Update targeted SDK of VOPlayerDemo application to API 28.

[SAMPLE_APP]

• Support for license acquisition type (Temporary or Persistent) in

VOPlayerDemo.
[SAMPLE_APP]

• New IsAudioDescription API in VOAudioTrack class.

[HLS]

• Adding seekTo feature when using WebVTT external subtitles.

[CORE]

• Adding M4TOOL_CIRCBUF module to dynamic logs system.

[DEBUG]

• Robutness of security breaches detection mechanism.

[SECURITY]

This document is Viaccess SA or Orca Interactive intellectual property. 7

Copying is strictly forbidden.
Confidential ‐ under NDA
 VO Player 08.05 Android Release Notes
Release overview
VO Player 08.05

Type Severity Tags & description

BUGFIXES HIGH • N/A

MEDIUM • Fixed DASH VOD TTML subtitles not displayed in case of using an offset on
the TTML track.
[SUBTITLE (TTML)] [DASH]

• Protect with a mutex PerformPersonalization API against thread

concurrent access.
[PLAYREADY]

• Fix crash on some encrypted streams.

[CORE]

LOW • Rejecting AV1/opus codec variants for DASH/HLS.

[DASH][HLS]

• Robustness on HTTP stack with regards to timeout connection.

[CORE]

• Catch UnsatisfiedLinkError and return VOException

ERROR_NOT_INITIALIZED when calling getUniqueIdentifier API.
[CORE]

This document is Viaccess SA or Orca Interactive intellectual property. 8

Copying is strictly forbidden.
Confidential ‐ under NDA
 VO Player 08.05 Android Release Notes
Release overview
VO Player 08.05

VO Player 08.05.01 - February 07th 2019

Type Severity Tags & description
CHANGES HIGH • N/A

MEDIUM • N/A

LOW • N/A

BUGFIXES HIGH • Fix subtitles not displayed on latest Chrome WebView (version 72).
[SUBTITLE]

MEDIUM • Fix race condition error when using setAudioTrack() between calling
prepareAsync() and start().
[CORE]

• Fix bad codec mode retrieved from FAAS server after an update of the OS or
SDK.
[CORE]

• Improved robustness on Scrubbing feature (memory leaks, performances…).

[SCRUBBING]

• Fix error 3103 after reset when playing HLS discretix protected content.
[PLAYREADY]

LOW • Fix non working skip-Ad on VAST if called too early.

[ADS]

• Robustness on HTTP stack with regards to socket disconnection and facing

random server errors.
[CORE]

• Robustness on Audio/Video synchronization when audio track differs from

the default one and set before prepare playback.
[CORE]

• Return proper error code when licence file is invalid.

[CORE]

• Frozen video display for a few seconds on playback start when setting non-
default audio track.
[MSS] [EXPERIENCE]

This document is Viaccess SA or Orca Interactive intellectual property. 9

Copying is strictly forbidden.
Confidential ‐ under NDA
 VO Player 08.05 Android Release Notes
Release overview
VO Player 08.05

VO Player 08.05.00 - January 30th 2019

Type Severity Tags & description
CHANGES HIGH • Deprecated oninfo event replaced by oninformation with a new
Object parameter.
[CORE]

• Sprite-based scrubbing uses new API setThumbnailUrl(String

fileUrl ScrubbingSpriteInfo spriteInfo).
[SCRUBBING]

MEDIUM • Improved support for custom User-Agent usage (better coverage in SDK
requests + configurable through .vop file in sample app).
[CORE]

• New getCodecName API to retrieve audio and video codec names.

[CORE]

• New getDRMAgentCapabilities API to retrieve suported DRM and their

security level.
[CORE]

• New seekTo(int msec, int accuracy) API allowing for accuracy

control (chunk or I-Frame).
[CORE]

• New startAt(double startTime, int accuracy) API allowing for

accuracy control (chunk or I-Frame).
[CORE]

• New setHttpStreamingOutputHttpHeaderFiltering API allowing

getting a callback on specific HTTP headers.
[CORE]

• New deleteRights and getRightsInfo API in Widevine DRM Agent.

[WIDEVINE]

• Automatic detection of STOV content in MSS.

[MSS]

LOW • Changes in settings menu UI organization.

[SAMPLE_APP]

• Adding more details on setCustomMode API behavior.

[DOC]

• Adding DEMUX, SUBTITLE_READER, HTTPSTR_READER, HSDM modules to

dynamic logs system.
[DEBUG]

• Switching INFO and ENTRY levels in dynamic logs system.

[DEBUG]

This document is Viaccess SA or Orca Interactive intellectual property. 10

Copying is strictly forbidden.
Confidential ‐ under NDA
 VO Player 08.05 Android Release Notes
Release overview
VO Player 08.05

Type Severity Tags & description

BUGFIXES HIGH • Fix playback DRM error happening after deleting personalization.
[PLAYREADY]

MEDIUM • Fix crash in HLS playlist parsing when there is no supported alternate track.
[HLS]

LOW • Fix possible crash in demux if fed corrupted data.

[CORE]

• Fix mutex locked issue when sending unsupported URL to VO Downloader.

[DOWNLOAD]

• Fix current Audio/Subtitle value not updated while in pause.

[CORE]

• Improved screen recording detection on Verimatrix streams.

[VERIMATRIX] [SECURITY]

• Improved screen resolution detection for TV devices.

[EXPERIENCE]

• Fix possible flickering of image based subtitles.

[SUBTITLE (SMPTE/TTML)]

• Fix possible IP resolving issue on HTTP proxy after

disconnection/reconnection.
[CORE]

• Improve VOP media file description in VOPlayer_Demo_App_guide.pdf.

[DOC]

This document is Viaccess SA or Orca Interactive intellectual property. 11

Copying is strictly forbidden.
Confidential ‐ under NDA
 VO Player 08.05 Android Release Notes
Release details
VO Player 08.05

Release details

Features
We are delighted to announce VO Player 8.5 readiness with the following additions:

• Reduce significantly your CDN and storage cost by deploying one single HLS Widevine encrypted stream
across your devices
• Enjoy better seeking user experience via responsive scrubbing (HLS WebVTT) and I-frame accurate
seeking
• Enable new monetization business model through VAST compliant ad servers such as Google Ad Server
• Reinforce content security for subscription models with state of the art white box cryptographic security
tool and third party live watermarking solutions
• Deploy your branded stand-alone app on PC and Mac leveraging rich all-in-one Angular 2 framework

Important
Reinforced White box security on mobiles and tablets for Playready results into an increase of 5MB
code. It also implies the loss of acquired playready licenses while moving from VOPlayer 8.4.x to 8.5.x.
This new implementation also removes the playready customer SDK, the customer secrets are now
managed in quickplayer.lic file.

Known SDK limitations

Dash offline viewing
No progress notification is fired in case of DASH ByteRange download.

VMAP post-roll "Skip Advertisement"

Skipping advertisement on post-roll ads is currently not supported.

AudioBooster with advertisements

AudioBooster feature cannot be enabled on advertisement contents that are requested with
AdSetRequest API.

Subtitles
DVB subtitle track must be set prior to starting the playback to have subtitles displayed.

This document is Viaccess SA or Orca Interactive intellectual property. 12

Copying is strictly forbidden.
Confidential ‐ under NDA
 VO Player 08.05 Android Release Notes
Release details
VO Player 08.05

Chromecast
• Using alternate parameters for Chromecast can ditter audio and subtitles tracks management
• Known issues for support of DASH Live content on Chromecast (device issues)

Scrubbing
• Scrubbing module could produce playback buffering if devices bandwidth is low

Widevine
• PlaybackDurationRemaining value for Widevine persistent license starts decreasing after few seconds of
playback (may varying from 10s up to 1 min). It seems device and type of licence specific.
• LicenceDurationRemaining may not have effects on Android version below 5.0. Even if the the license is
detected has expired the CDM Widevine allows the playback.
• On Android version 4.x, 6.x, 7.x when only LicenceDurationRemaining is set, the license management
behaviour is playback duration instead of License duration management: the license rights starts
decreasing only after playback started.
• getKeyStatus information available only on device with API Android superior to 23

API updates
• Add getDRMAgentCapabilities API in order to retrieve SDK’s suported DRM and their security level.
• Add getCodecName API in order to retrieve audio and video codec name.
• Add seekTo(int msec, int accuracy) API for control accuracy in order to improve experience.
Accuracy could be chunk or I-Frame.
• Add startAt(double startTime, int accuracy) API for control accuracy in order to improve
experience. Accuracy could be chunk or I-Frame.
• Add setHttpStreamingOutputHttpHeaderFiltering(VOMediaInfoHeaderFileType
httpHeaderFileType, string httpHeaderKeyWord) Api for control the HTTP Header callback
with filters.
• Add setThumbnailUrl(String fileUrl, ScrubbingSpriteInfo spriteInfo) Api to handle
Scrubbing module.
• Deprecated oninfo replace by oninformation with a new parameter Object.

This document is Viaccess SA or Orca Interactive intellectual property. 13

Copying is strictly forbidden.
Confidential ‐ under NDA
 VO Player 08.05 Android Release Notes
Patch release notes keywords
VO Player 08.05

Patch release notes keywords

In order to bring better clarity on patch releases updates (changes & bug fixes), a new change log template
is used with a better impact description. It should help decision process to switch to a release or not.

• A dedicated severity (High, Medium, Low) is assigned to each updates.

• Moreover a dedicated tag gives the feature impact of this updates.

The following criteria defines the Severity level

• HIGH - crash or major error AND easy reproducible AND impacting more than one customer.
• MEDIUM - crash or error AND less reproducible OR related to one specific customer or its integration.
• LOW - error only (excluding crash) AND affecting limited set of streams OR related to any VO materials
(doc, sample code).

The following tags are used to scope the update impact

• AES / FAIRPLAY / PLAYREADY / VERIMATRIX / WIDEVINE - used if the change applies to a specific DRM
only.
• API - used if the change applies to the VOPlayer API only.
• DASH / HLS / MSS / MP4 - used if the change applies to a specific protocol only.
• DOWNLOAD / LIVE / START_OVER / TIMESHIFT / VOD - used if the change applies to a use case only.
• ADS - used for changes affecting advertising features only (may be followed by VAST, VMAP, IMA).
• AIRPLAY - used for airplay related features.
• ANALYTICS - used for changes affecting analytics plugins.
• AUDIO - used for changes affecting audio only.
• BUILD - used for changes done to resolve build problems.
• CORE - used if change is multi DRM, protocols.
• CHROMECAST - used for chromecast related features.
• DEBUG - used for changes impacting only debug SDK.
• DOC - used for documentation changes only.
• EXPERIENCE - used for changes affecting video playback experience only such as performances, start-up
time, latency.
• NATIVE_PLAYER - used for changes related to iOS native player feature.
• PERSONALIZATION - used for changes related to personalization.
• RELEASE_CONTENT - used for changes affecting Release package content.
• SAMPLE_APP - used for sample code changes only without impacting SDK.
• SCRUBBING - used for changes affecting scrubbing related features.

This document is Viaccess SA or Orca Interactive intellectual property. 14

Copying is strictly forbidden.
Confidential ‐ under NDA
 VO Player 08.05 Android Release Notes
Patch release notes keywords
VO Player 08.05

• SECURITY - used for security related changes (may be followed by DEVICE-ID, ROOTED).
• SUBTITLE - used for changes affecting subtitling features only (may be followed by WEBVTT, TTML,
SMPTE-TT, DVB-SUB).
• NWJS - used for changes relate to NWJS runtime used for the Desktop solution

Note
This list is not exhaustive and will be updated with other keywords whenever required.

This document is Viaccess SA or Orca Interactive intellectual property. 15

Copying is strictly forbidden.
Confidential ‐ under NDA
 VO Player 08.05 Android Release Notes
Delivery Package
VO Player 08.05

Delivery Package

The delivery package contains:

• The documentation
◦ The product description
◦ This release note
◦ The integration guide
◦ Appendices to the integration guide for DRM support (optional, depending on VO Player SDK DRM
flavor)
◦ The javadoc
◦ The VOPlayer demo application guide (folder VOPlayerDemo)
• The SDK
◦ A release version
◦ A debug version of the SDK that should be used for bug reporting
• The VOPlayer application sample code
• Optionally, a sample ChromeCast custom receiver (folder SampleChromeCastReceiver)
• On General SDK, a demo APK application of the VOPlayer application
• Some analytics plugins

Important
Viaccess-Orca must provide you a license (quickplayer.lic) in order to remove the logo and enable pro
features (see the Product Description).

This document is Viaccess SA or Orca Interactive intellectual property. 16

Copying is strictly forbidden.
Confidential ‐ under NDA