Media Info Requirements

[jlacivita]

Adds a variety of methods so apps can get the capabilities of the device and its peripherals before attempting to play media.

New modules:

MediaCapabilities

For querying the capabilities of the entire AV system (including the device, display, and soundbar/AV receiver).

• audioCodecs: The supported audio codecs, e.g. [aac, ac3, ac4, eac3]
• videoCodecs: The supported video codecs, e.g. [av1, avc, hevc]
• atmosSupported: Check whether Atmos is supported
• colorDepth: The maximum supported color depth, e.g. 10
• hdrFormats: The supported HDR formats, e.g. [hdr10, hdr10plus, hlg]
• preferredVideoMode: The best-supported video output mode, e.g. 1080p60

Display

For querying the capabilities of the display panel

• colorimetry: The supported colorimetry values from the display, e.g. [BT2020RGB, BT2020YCC]
• nativeResolution: The display's advertised native resolution, e.g. {width: 1920, height: 1080}
• size: The physical width and height of the display (in centimeters), e.g. {width: 157, height: 91}
• videoModes: The supported video modes of the display, e.g. [1080p50, 1080p60]

AudioOutput

For accessing the device's audio output system

• mode: The current audio output mode setting of the device, e.g. auto
• status: The current audio output status, e.g. {mode: "stereo"}

VideoOutput

For accessing the device's video output system

• status: The current video output status, e.g. {colorDepth: 10, hdrFormat: "hdr10", mode: 1080p60"}
• onModeWillChange: An event that fires when the device's video output mode changes but before it takes effect

Deprecated Methods

• Device.hdr: Team decided to deprecate booleanMap methods; superceded by MediaCapabilities.hdrFormats
• Device.screenResolution: The web screen/graphical resolution; apps can get their current screen/window size using standard web or wayland APIs
• Device.videoResolution: The maximum supported video resolution; removed in favor of the more descriptive MediaCapabilities.preferredVideoMode

[github-actions]

MFOS standalone sanity report - CORE,MANAGE,DISCOVERY:
Total Passes - 498 Failures - 0 Pending - 0 Skipped - 28
Report JSON/HTML Files: https://github.com/rdkcentral/firebolt-apis/suites/29076451507/artifacts/2001595791
Job Logs: https://github.com/rdkcentral/firebolt-apis/actions/runs/11128695697

[github-actions]

MFOS standalone sanity report - CORE,MANAGE,DISCOVERY:
Total Passes - 498 Failures - 25 Pending - 0 Skipped - 28
Report JSON/HTML Files: https://github.com/rdkcentral/firebolt-apis/suites/29127556241/artifacts/2006986710
Job Logs: https://github.com/rdkcentral/firebolt-apis/actions/runs/11147868660