Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

音訊功能

Android TV 支援多個並行音訊輸出：電視喇叭、HDMI 家庭劇院、藍牙等。這些裝置支援不同的編碼 (例如 Dolby Digital+、DTS、PCM)、取樣率和聲道。透過 HDMI 連接的電視支援多種格式，但藍牙僅支援 PCM。

播放期間，可用的音訊裝置和轉送方式可能會變更：使用者可能會熱插拔 HDMI、連線藍牙或修改設定。應用程式必須妥善調整，確保能使用新裝置的功能持續播放。不支援的格式可能會導致錯誤或無聲。

提供多種編碼，根據裝置功能提供最佳體驗。舉例來說，如果支援 Dolby Digital，系統就會使用該格式，否則應用程式會改用 PCM。如要瞭解將串流轉換為 PCM 的 Android 解碼器，請參閱「支援的媒體格式」。

播放時，串流應用程式應使用輸出音訊裝置支援的最佳 AudioFormat 建立 AudioTrack。

建立格式正確的音軌

應用程式應建立 AudioTrack、開始播放，並呼叫 getRoutedDevice()，判斷要播放音效的預設音訊裝置。例如，這可以是安全的短暫靜音 PCM 編碼音軌，僅用於判斷路由裝置及其音訊功能。

取得支援的編碼

使用 getAudioProfiles() (API 級別 31 以上) 或 getEncodings() (API 級別 23 以上)，判斷預設音訊裝置可用的音訊格式。

查看支援的音訊設定檔和格式

使用 AudioProfile (API 級別 31 以上) 或 isDirectPlaybackSupported() (API 級別 29 以上)，檢查支援的格式、聲道數量和取樣率組合。

部分 Android 裝置可支援輸出音訊裝置不支援的編碼。這些額外格式應透過 isDirectPlaybackSupported() 偵測。在這種情況下，音訊資料會重新編碼為輸出音訊裝置支援的格式。即使所選格式未出現在 getEncodings() 傳回的清單中，也請使用 isDirectPlaybackSupported() 正確檢查是否支援該格式。

預期性音訊路由

Android 13 (API 級別 33) 推出預測音訊路徑。您可以預測裝置音訊屬性支援，並為使用中的音訊裝置準備音軌。您可以使用 getDirectPlaybackSupport()，檢查目前轉送的音訊裝置是否支援特定格式和屬性的直接播放功能：

Kotlin

val format = AudioFormat.Builder()
    .setEncoding(AudioFormat.ENCODING_E_AC3)
    .setChannelMask(AudioFormat.CHANNEL_OUT_5POINT1)
    .setSampleRate(48000)
    .build()
val attributes = AudioAttributes.Builder()
    .setUsage(AudioAttributes.USAGE_MEDIA)
    .build()

if (AudioManager.getDirectPlaybackSupport(format, attributes) !=
    AudioManager.DIRECT_PLAYBACK_NOT_SUPPORTED
) {
    // The format and attributes are supported for direct playback
    // on the currently active routed audio path
} else {
    // The format and attributes are NOT supported for direct playback
    // on the currently active routed audio path
}AudioCapabilities.kt

Java

AudioFormat format = new AudioFormat.Builder()
        .setEncoding(AudioFormat.ENCODING_E_AC3)
        .setChannelMask(AudioFormat.CHANNEL_OUT_5POINT1)
        .setSampleRate(48000)
        .build();
AudioAttributes attributes = new AudioAttributes.Builder()
        .setUsage(AudioAttributes.USAGE_MEDIA)
        .build();

if (AudioManager.getDirectPlaybackSupport(format, attributes) !=
        AudioManager.DIRECT_PLAYBACK_NOT_SUPPORTED) {
    // The format and attributes are supported for direct playback
    // on the currently active routed audio path
} else {
    // The format and attributes are NOT supported for direct playback
    // on the currently active routed audio path
}

或者，您也可以查詢目前轉送的音訊裝置支援哪些設定檔，以便直接播放媒體。這會排除任何不支援的設定檔，或由 Android 架構轉碼的設定檔，例如：

Kotlin

private fun findBestAudioFormat(audioAttributes: AudioAttributes): AudioFormat {
    val preferredFormats = listOf(
        AudioFormat.ENCODING_E_AC3,
        AudioFormat.ENCODING_AC3,
        AudioFormat.ENCODING_PCM_16BIT,
        AudioFormat.ENCODING_DEFAULT
    )
    val audioProfiles = audioManager.getDirectProfilesForAttributes(audioAttributes)
    val bestAudioProfile = preferredFormats.firstNotNullOf { format ->
        audioProfiles.firstOrNull { it.format == format }
    }
    val sampleRate = findBestSampleRate(bestAudioProfile)
    val channelMask = findBestChannelMask(bestAudioProfile)
    return AudioFormat.Builder()
        .setEncoding(bestAudioProfile.format)
        .setSampleRate(sampleRate)
        .setChannelMask(channelMask)
        .build()
}AudioCapabilities.kt

Java

private AudioFormat findBestAudioFormat(AudioAttributes audioAttributes) {
    Stream<Integer> preferredFormats = Stream.<Integer>builder()
            .add(AudioFormat.ENCODING_E_AC3)
            .add(AudioFormat.ENCODING_AC3)
            .add(AudioFormat.ENCODING_PCM_16BIT)
            .add(AudioFormat.ENCODING_DEFAULT)
            .build();
    Stream<AudioProfile> audioProfiles =
            audioManager.getDirectProfilesForAttributes(audioAttributes).stream();
    AudioProfile bestAudioProfile = (AudioProfile) preferredFormats.map(format ->
            audioProfiles.filter(profile -> profile.getFormat() == format)
                    .findFirst()
                    .orElseThrow(NoSuchElementException::new)
    );
    Integer sampleRate = findBestSampleRate(bestAudioProfile);
    Integer channelMask = findBestChannelMask(bestAudioProfile);
    return new AudioFormat.Builder()
            .setEncoding(bestAudioProfile.getFormat())
            .setSampleRate(sampleRate)
            .setChannelMask(channelMask)
            .build();
}

在這個範例中，preferredFormats 是 AudioFormat 執行個體的清單。清單會依偏好程度排序，最偏好的排在最前面，最不偏好的排在最後面。getDirectProfilesForAttributes() 會傳回目前轉送音訊裝置支援的 AudioProfile 物件清單，並提供 AudioAttributes。系統會逐一檢查偏好的 AudioFormat 項目清單，直到找到相符的支援 AudioProfile 為止。這個 AudioProfile 會儲存為 bestAudioProfile。最佳取樣率和聲道遮罩取決於 bestAudioProfile。最後，系統會建立適當的 AudioFormat 執行個體。

建立音軌

應用程式應使用這項資訊，為預設音訊裝置支援的最高品質 AudioFormat (且適用於所選內容) 建立 AudioTrack。

攔截音訊裝置變更

如要攔截及回應音訊裝置變更，應用程式應：

如果 API 級別等於或大於 24，請新增 OnRoutingChangedListener，監控音訊裝置變更 (HDMI、藍牙等)。
如果是 API 級別 23，請註冊 AudioDeviceCallback，接收可用音訊裝置清單的變更。
如果是 API 級別 21 和 22，請監控 HDMI 插入事件，並使用廣播中的額外資料。
此外，請註冊 BroadcastReceiver，監控 API 23 以下裝置的 BluetoothDevice 狀態變更，因為系統尚未支援 AudioDeviceCallback。

偵測到 AudioTrack 的音訊裝置變更時，應用程式應檢查更新後的音訊功能，並視需要使用不同的 AudioFormat 重新建立 AudioTrack。如果現在支援更高品質的編碼，或不再支援先前使用的編碼，請執行這項操作。

程式碼範例

Kotlin

// audioPlayer is a wrapper around an AudioTrack
// which calls a callback for an AudioTrack write error
audioPlayer.addAudioTrackWriteErrorListener {
    // error code can be checked here,
    // in case of write error try to recreate the audio track
    restartAudioTrack(findDefaultAudioDeviceInfo())
}

audioPlayer.audioTrack.addOnRoutingChangedListener({ audioRouting ->
    audioRouting?.routedDevice?.let { audioDeviceInfo ->
        // use the updated audio routed device to determine
        // what audio format should be used
        if (needsAudioFormatChange(audioDeviceInfo)) {
            restartAudioTrack(audioDeviceInfo)
        }
    }
}, handler)AudioCapabilities.kt

Java

// audioPlayer is a wrapper around an AudioTrack
// which calls a callback for an AudioTrack write error
audioPlayer.addAudioTrackWriteErrorListener(new AudioTrackPlayer.AudioTrackWriteError() {
    @Override
    public void audioTrackWriteError(int errorCode) {
        // error code can be checked here,
        // in case of write error try to recreate the audio track
        restartAudioTrack(findDefaultAudioDeviceInfo());
    }
});

audioPlayer.getAudioTrack().addOnRoutingChangedListener(new AudioRouting.OnRoutingChangedListener() {
    @Override
    public void onRoutingChanged(AudioRouting audioRouting) {
        if (audioRouting != null && audioRouting.getRoutedDevice() != null) {
            AudioDeviceInfo audioDeviceInfo = audioRouting.getRoutedDevice();
            // use the updated audio routed device to determine
            // what audio format should be used
            if (needsAudioFormatChange(audioDeviceInfo)) {
                restartAudioTrack(audioDeviceInfo);
            }
        }
    }
}, handler);

「聽聲辨曲」資訊卡中的背景播放功能

調整顯示設定

音訊功能 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

建立格式正確的音軌

取得支援的編碼

查看支援的音訊設定檔和格式

預期性音訊路由

Kotlin

Java

Kotlin

Java

建立音軌

攔截音訊裝置變更

程式碼範例

Kotlin

Java

音訊功能