defagos
commented
1 year ago As discussed with @amtins and @StaehliJ, the Pillarbox player API will not provide clever behaviors like what SRG Media Player currently does on Apple platforms. For example we won't implement a mode where switching the audio track chooses the best possible language for subtitles, based on device or application language. If this is later needed this behavior can be provided with higher-level APIs, but the low-level API should be kept simple.
In particular automatic selection should only be based on master playlist content. Usually AUTOSELECT and DEFAULT should be set to NO. By default players will behave accordingly (e.g. show subtitles if DEFAULT has been set to YES for some subtitles). If not desired then either packaging should be updated to reflect better defaults or apps integrating the player should use provided APIs to override the default.
There will be only two exceptions that will be dealt with at the player level:
- Forced subtitles should be hidden from view and transparently associated with content based on audio language selection:
- The player public API for subtitles will not return forced subtitles.
- Forced subtitles cannot be set using the player public API.
- When clearing subtitles the player will automatically enable forced subtitles for the current audio language, if any.
- AD and SDH system preferences will be implemented by the player where applicable.
amtins
As a team we need to have a common understanding of what our API should provide and what it should not.
Acceptance criteria
Tasks