Maintenance release

This version updates SRG Media Player to version 2.3, fixing a player state inconsistency issue.

Heartbeats fix

• Fix incorrect segment information in heartbeats (#25).
• Device information is now sent in the new navigation_device label.
• The method -[SRGMediaComposition resourceWithPreferredStreamingMethod:streamType:quality:startBitRate:completionBlock:] added to SRGAnalytics_SRGDataProvider.framework can be used to retrieve a resource, with the same resolution criteria previously applied when playing content.
• The existing media composition streamingMethod and quality properties, available when using SRGAnalytics_SRGDataProvider.framework, have been replaced with a single resource property containing all resource information.

TagCommander background measurements

• TagCommander measurements are now performed in background. This is especially useful for heartbeats (uptime and pos) sent during background playback.
• When using the SRGAnalytics_DataProvider.framework companion framework, and for resources equivalently fitting the same set of playback settings, HTTPS resources will be preferred over HTTP resources. Previously, depending on the (unreliable) order of such resources, playback would either occur over HTTP or HTTPS, which could lead to seemingly random failures if App Transport Security was not allowing HTTP playback.

Preferred stream type and 360° video support

When using the SRGDataProvider_SRGAnalytics bridge framework to play some media:

• You can now choose the stream type to use if available (e.g. a livestream with no DVR support).
• Media playback is automatically configured for 360° videos.

Support for value overrides and page_id removal

A page_id label was sent in TagCommander page view information but was not used for measurements. Some teams need to use this label for other purposes, and having this information filled for no specific need was misleading. The label has therefore been dropped.

Some teams also needed a way to override internal labels sent in measurements. This was in fact already possible by providing a different value in customInfo labels, but this behavior was not officially documented. This possibility is now part of custom label supported features and documented as such.

Fix crashes on iOS 9

Crashes related to page view measurements could sometimes occur on iOS 9. Those have been fixed.

Analytics labels and media composition updates during playback

This releases makes it possible to update analytics labels and media composition during playback. Previously, this information could only be provided when starting playback.

Simply set the analyticsLabels (if you are using SRGAnalytics_SRGMediaPlayer.framework) or mediaComposition (if you are using SRGAnalytics_SRGDataProvider.framework) properties with the updated values when appropriate.

SRG SSR General Direction site identifier by default

• By default, TagCommander measurements are now sent to the SRG SSR General Direction site identifier.
• TagCommander verbose logging is now inhibited. You can still enable it at the application level if needed.

TagCommander integration

This major release adds TagCommander support. Introduction of this new tag management system required breaking changes to the public library API, but its scope and principles have not been altered.

Please read our migration guide for a quick introduction to the most important changes you have to take into account when migrating your code.

Version 3.0 also provides support of stream tracking for applications not using our SRG Media Player library. Please read SRGAnalyticsStreamTracker documentation for more information.

Moreover, this version updates NetMetrix tracking to comply with updated rules (see https://www.net-metrix.ch/service/vorgaben/zusaetzliche-vorgaben-apps for German, and https://www.net-metrix.ch/fr/service/directives/directives-supplementaires-pour-les-applications for French).

Compatibility with SRG DataProvider 5.4

This version is only a compatibility release with SRG DataProvider 5.4 and contains no particular change.