类：AudioTracksManager
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
如未另行说明，那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可，并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情，请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC)：2025-07-25。
[null,null,["最后更新时间 (UTC)：2025-07-25。"],[[["\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."]]
