SRGSSR / pillarbox-documentation

Technical cross-platform documentation for Pillarbox
3 stars 0 forks source link

Align `uptime` behavior with Android and the web #39

Closed defagos closed 11 months ago

defagos commented 12 months ago

As a Pillarbox team member I want the same rules to be applied for uptime intervals.

Acceptance criteria

Tasks

defagos commented 11 months ago

After discussion with @amtins, @waliid and @StaehliJ:

defagos commented 11 months ago

Next step: Ask for @pyby opinion first, then ask the GD.

defagos commented 11 months ago

Note that uptime is currently only sent in live conditions, as noted by @pyby. So this event might still have a purpose, namely measuring the consumption in live conditions. We should ask ADI / RTS analysts if there are associated reports to find whether uptime is still useful or not.

defagos commented 11 months ago

According to the implementation concept:

The UPTIME event is a special Meida Action that is used by Webtrekk to calculate the amount of concurrent views in a minute-by-minute trending analysis on live streamings. The Media Action UPTIME should be sent every 60 seconds, with a 30 second initial delay form the first PLAY Media Action. Parameters that should be sent within every UPTIME Media Actions are: wt_sendinfo_media(mi, ‘uptime’, mt1, mt2, bw, vol, mut, x); If the live streaming enters the “time shifted mode”, since Webtrekk supports VOD tracking the event UPTIME should not be sent anymore as it only is needed for synchronous tracking of media players connected to the live broadcasting (to analyze the number of visitors connected to the live broadcasting every single minute).

So I guess we should keep our original Letterbox implementation after all.

defagos commented 11 months ago

An issue has been created for the Apple implementation.

defagos commented 11 months ago

The 3 implementations should be aligned for intervals but we still have to check whether we are (more or less) aligned about sending near the live edge.

defagos commented 11 months ago

Letterbox web was not implementing the live edge criterium (since day one). This will be fixed and implemented in Pillarbox web as well.

Letterbox web also implements a different approach to timers (the timer is running all the time and checks after 30s, then periodically every 60s, whether the player is actually playing before sending an uptime).

amtins commented 11 months ago

I took the time to create an issue as well as to reread the official specification very carefully. It appears that the specification contradicts itself, so depending on which definition you use, you have a 50% chance of making a mistake.

Please refer to the scenario in Story 4 (Seeking a livestream) of the documentation standard streaming events: sequence of events for media player actions

Finally, after reading a new specification, even if it's older than the standard specification to be used for players, it mentions tracking the event UPTIME should not be sent anymore so it's SHOULD and not a MUST, what should we conclude from this?

*Edit: I quickly compared with the TP and it's the exact same behavior

defagos commented 11 months ago

We received an answer from the GD that we should likely always send uptime, not only in live conditions.

defagos commented 11 months ago

Tasks created for Android and Apple.