Définit la piste audio dont l'état correspond à id.
Paramètres
id
number
ID du titre
Génère
non-null Error si id n'est pas un ID de piste audio.
setActiveByLanguage
setActiveByLanguage(language)
Définit la première piste audio dont l'état correspond à language.
Paramètres
language
chaîne
Tag de langue conforme à la norme RFC 5646.
Génère
non-null Error si language n'est pas disponible ou n'est pas valide.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/25 (UTC).
[null,null,["Dernière mise à jour le 2025/07/25 (UTC)."],[[["\u003cp\u003eThe \u003ccode\u003eAudioTracksManager\u003c/code\u003e class within the cast.framework manages audio tracks for the Web Receiver application.\u003c/p\u003e\n"],["\u003cp\u003eIt provides methods to get the active audio track, retrieve tracks by ID or language, and set the active track.\u003c/p\u003e\n"],["\u003cp\u003eAudioTracksManager instances should be obtained using \u003ccode\u003ecast.framework.PlayerManager#getAudioTracksManager\u003c/code\u003e, direct instantiation throws an error.\u003c/p\u003e\n"],["\u003cp\u003eMethods like \u003ccode\u003egetTracksByLanguage\u003c/code\u003e and \u003ccode\u003esetActiveByLanguage\u003c/code\u003e use language tags according to RFC 5646.\u003c/p\u003e\n"],["\u003cp\u003eSeveral methods may throw errors if provided IDs or languages are invalid or unavailable.\u003c/p\u003e\n"]]],["The `AudioTracksManager` class manages audio tracks, accessed via `PlayerManager`. It retrieves track information like the active track ID/object, tracks matching a specific ID or language, and all tracks. You can set a track as active by its ID or language. Direct construction of `AudioTracksManager` is prohibited; you must obtain an instance through `PlayerManager`. Errors are thrown for invalid or unavailable IDs or languages.\n"],null,["# Class: AudioTracksManager\n\ncast.[framework](/cast/docs/reference/web_receiver/cast.framework).AudioTracksManager\n=====================================================================================\n\nclass static\n\nManages audio tracks.\n\nThrows\n\n: `non-null Error` if the constructor is used directly.\n The `AudioTracksManager` should be instantiated\n by calling [cast.framework.PlayerManager#getAudioTracksManager](/cast/docs/reference/web_receiver/cast.framework.PlayerManager#getAudioTracksManager).\n\nMethods\n-------\n\n### getActiveId\n\ngetActiveId() returns number\n\nGets the active audio track ID.\n\nReturns\n\n: `nullable number`\n\n### getActiveTrack\n\ngetActiveTrack() returns [cast.framework.messages.Track](/cast/docs/reference/web_receiver/cast.framework.messages.Track)\n\nGets the active audio track.\n\nReturns\n\n: `nullable `[cast.framework.messages.Track](/cast/docs/reference/web_receiver/cast.framework.messages.Track)\n\n### getTrackById\n\ngetTrackById(id) returns [cast.framework.messages.Track](/cast/docs/reference/web_receiver/cast.framework.messages.Track)\n\nGets the audio track that matches `id`.\n\n| #### Parameter ||\n|----|--------|\n| id | number |\n\nThrows\n\n: `non-null Error` if `id` is unavailable or invalid.\n\nReturns\n\n: `nullable `[cast.framework.messages.Track](/cast/docs/reference/web_receiver/cast.framework.messages.Track)\n\n### getTracks\n\ngetTracks() returns Array of non-null [cast.framework.messages.Track](/cast/docs/reference/web_receiver/cast.framework.messages.Track)\n\nReturns all audio tracks.\n\nReturns\n\n: `non-null Array of non-null `[cast.framework.messages.Track](/cast/docs/reference/web_receiver/cast.framework.messages.Track)\n\n### getTracksByLanguage\n\ngetTracksByLanguage(language) returns Array of non-null [cast.framework.messages.Track](/cast/docs/reference/web_receiver/cast.framework.messages.Track)\n\nGets all the audio tracks that match `language`.\n\n| #### Parameter ||\n|----------|--------------------------------------|\n| language | string Language tag as per RFC 5646. |\n\nThrows\n\n: `non-null Error` if `language` is not available.\n\nReturns\n\n: `non-null Array of non-null `[cast.framework.messages.Track](/cast/docs/reference/web_receiver/cast.framework.messages.Track)\n\n### setActiveById\n\nsetActiveById(id)\n\nSets the audio track that matches `id` to the active state.\n\n| #### Parameter ||\n|----|---------------------|\n| id | number The track ID |\n\nThrows\n\n: `non-null Error` if `id` is not an audio track ID.\n\n### setActiveByLanguage\n\nsetActiveByLanguage(language)\n\nSets the first audio track that matches `language` to the active state.\n\n| #### Parameter ||\n|----------|--------------------------------------|\n| language | string Language tag as per RFC 5646. |\n\nThrows\n\n: `non-null Error` if `language` is not available or invalid."]]
