react-native-audio-browser 0.2.0-next.15 → 0.2.0-next.17

package/src/types/browser-nodes.ts

@@ -547,6 +547,21 @@ export interface Track {
    * calls. Declare it on every live track.
    */
   live?: boolean
+
+  /**
+   * Byte encoding of this track's ICY `StreamTitle` when it is not UTF-8, as
+   * an IANA label (`'windows-1251'`, `'windows-874'`, …). Some Shoutcast /
+   * Icecast stations send titles in a legacy code page; ICY declares no
+   * encoding, so the player's UTF-8 decode fails and falls back to Latin-1,
+   * showing mojibake. With this set, a title that came out Latin-1 shaped
+   * (every char at or below U+00FF, some at or above U+0080) is re-decoded
+   * through ISO-8859-1 with the given charset; this also repairs stations
+   * that UTF-8 encoded their legacy bytes. A title already in another script
+   * or pure ASCII is left alone. Applies to ICY only: ID3 and HLS timed
+   * metadata declare their own encoding and are never touched. A label the
+   * platform cannot decode with is ignored.
+   */
+  icyCharset?: string
 }
 
 /**

package/website/guide/track.md

@@ -149,6 +149,7 @@ Optional fields that change how a Track renders on CarPlay / Android Auto. Each
 | `favorited`                                | filled/empty heart (needs the `favorite` capability)                   | Android Auto, notification |
 | `live`                                     | a "live" indicator                                                     | iOS now-playing            |
 | `albumPath`                                | make the now-playing album line tappable                               | CarPlay                    |
+| `icyCharset`                               | decode ICY titles a station sends in a legacy code page                | iOS, Android               |
 
 A couple of constraints worth knowing: