OptionaladOptionaladOptionalaudioOptionalcastOptionalcastOptionalcolorsOptionalcustomUp to 8 host icon buttons in the control chrome; taps land in
onCustomAction(index).
OptionaldimensDimension tokens of the built-in controls in dp / pt — any subset of OGControlDimens; unset tokens keep their defaults.
OptionalerrorReplace the SDK's default error copy, keyed by numeric error code;
"default" applies to unlisted codes. {code} in a value is
substituted with the actual error code. Wins over
strings.errorGeneric wherever it has text for the code.
Optionalerror0.13.1 — error-overlay message styling (hex color, sp/pt size, platform font family such as "serif").
OptionalerrorOptionalerrorOptionalfullscreenSet BOTH or neither — the SDK takes the pair together.
OptionalfullscreenOptionalhideHide every control — fully headless surface.
OptionallocaleBCP-47 language tag for track names the player derives itself. Web only for now: accepted here so one config fits every platform, and ignored by the Android and iOS players (their track names already follow the device).
OptionalpauseOptionalplayReplace built-in control glyphs by NATIVE drawable/asset name (the icon must exist in the app's native resources).
Optionalretry0.13.1 — Retry button styling.
OptionalretryOptionalretryRetry button text, any language. Wins over strings.retry.
OptionalretryOptionalseekOptionalseekOptionalshowOptionalshowOptionalshowOptionalshowOptionalshowOptionalshowOptionalshowOptionalshowOptionalshowOptionalshowOptionalshowOptionalshowOptionalshowOptionalshow"Up next" countdown card in the lead window before a playlist item ends (default true). false = the queue still auto-advances, silently.
OptionalshowOptionalstringsThe chrome's words in your language — any subset of OGStrings;
missing keys stay English. The same keys on every OGPlayer platform.
errorMessages, retryButtonLabel and upNextText win over their
strings counterparts when set.
OptionalsuppressHide the SDK's built-in error overlay entirely (onError still fires) — for hosts drawing their own error UI over the player.
OptionalupCard styling (hex color, sp/pt size, platform font family).
OptionalupOptionalupSeconds before the end at which the card appears (default 10, 1–60).
OptionalupCard text template — {seconds} and {title} are substituted
(default "Next in {seconds}"). Your copy, any language. Wins over
strings.upNext.
OptionalupOptionalup
Colour tokens of the built-in controls — any subset of OGControlColors (
#RRGGBB/#AARRGGBB); unset tokens keep their defaults.