Khả năng về âm thanh

Các thiết bị Android TV có thể kết nối nhiều thiết bị đầu ra âm thanh cùng lúc: loa TV, rạp hát tại nhà kết nối qua HDMI, tai nghe Bluetooth, v.v. Các thiết bị đầu ra âm thanh này có thể hỗ trợ nhiều chức năng âm thanh, chẳng hạn như mã hoá (Dolby Digital+, DTS và PCM), tốc độ lấy mẫu và kênh. Ví dụ: TV kết nối qua HDMI hỗ trợ nhiều định dạng mã hoá, trong khi tai nghe Bluetooth thường chỉ hỗ trợ PCM.

Danh sách các thiết bị âm thanh hiện có và thiết bị âm thanh được định tuyến cũng có thể thay đổi bằng cách cắm nóng các thiết bị HDMI, kết nối hoặc ngắt kết nối tai nghe Bluetooth hoặc người dùng thay đổi chế độ cài đặt âm thanh. Vì các chức năng đầu ra âm thanh có thể thay đổi ngay cả khi ứng dụng đang phát nội dung nghe nhìn, nên ứng dụng cần điều chỉnh một cách linh hoạt theo những thay đổi này và tiếp tục phát trên thiết bị âm thanh được định tuyến mới và các chức năng của thiết bị đó. Việc xuất sai định dạng âm thanh có thể dẫn đến lỗi hoặc không phát âm thanh.

Ứng dụng có khả năng xuất cùng một nội dung ở nhiều định dạng mã hoá để mang đến cho người dùng trải nghiệm âm thanh tốt nhất tuỳ thuộc vào chức năng của thiết bị âm thanh. Ví dụ: luồng âm thanh được mã hoá bằng Dolby Digital sẽ được phát nếu TV hỗ trợ định dạng này, trong khi luồng âm thanh PCM được hỗ trợ rộng rãi hơn sẽ được chọn khi không có hỗ trợ cho Dolby Digital. Bạn có thể tìm thấy danh sách các bộ giải mã Android tích hợp dùng để chuyển đổi luồng âm thanh thành PCM trong bài viết Các định dạng nội dung nghe nhìn được hỗ trợ.

Vào thời điểm phát, ứng dụng phát trực tuyến sẽ tạo một AudioTrack với AudioFormat tốt nhất được thiết bị âm thanh đầu ra hỗ trợ.

Tạo một bản nhạc có định dạng phù hợp

Ứng dụng nên tạo một AudioTrack, bắt đầu phát và gọi getRoutedDevice() để xác định thiết bị âm thanh mặc định dùng để phát âm thanh. Ví dụ: đây có thể là một bản nhạc được mã hoá bằng PCM có thời lượng ngắn và an toàn, chỉ dùng để xác định thiết bị được định tuyến và các chức năng âm thanh của thiết bị đó.

Nhận các định dạng mã hoá được hỗ trợ

Sử dụng getAudioProfiles() (cấp độ API 31 trở lên) hoặc getEncodings() (cấp độ API 23 trở lên) để xác định các định dạng âm thanh có trên thiết bị âm thanh mặc định.

Kiểm tra các định dạng và hồ sơ âm thanh được hỗ trợ

Sử dụng AudioProfile (cấp độ API 31 trở lên) hoặc isDirectPlaybackSupported() (cấp độ API 29 trở lên) để kiểm tra các tổ hợp được hỗ trợ về định dạng, số lượng kênh và tốc độ lấy mẫu.

Một số thiết bị Android có khả năng hỗ trợ các định dạng mã hoá ngoài những định dạng được thiết bị âm thanh đầu ra hỗ trợ. Bạn nên phát hiện các định dạng bổ sung này thông qua isDirectPlaybackSupported(). Trong những trường hợp này, dữ liệu âm thanh sẽ được mã hoá lại thành một định dạng được thiết bị âm thanh đầu ra hỗ trợ. Sử dụng isDirectPlaybackSupported() để kiểm tra đúng cách khả năng hỗ trợ cho định dạng mong muốn ngay cả khi định dạng đó không có trong danh sách do getEncodings() trả về.

Định tuyến âm thanh dự đoán

Android 13 (cấp độ API 33) đã giới thiệu các tuyến âm thanh dự đoán. Bạn có thể dự đoán khả năng hỗ trợ thuộc tính âm thanh của thiết bị và chuẩn bị các bản nhạc cho thiết bị âm thanh đang hoạt động. Bạn có thể sử dụng getDirectPlaybackSupport() để kiểm tra xem tính năng phát trực tiếp có được hỗ trợ trên thiết bị âm thanh hiện được định tuyến cho một định dạng và thuộc tính nhất định hay không:

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
}

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
}

Ngoài ra, bạn có thể truy vấn những hồ sơ được hỗ trợ để phát trực tiếp nội dung nghe nhìn thông qua thiết bị âm thanh hiện được định tuyến. Điều này loại trừ mọi hồ sơ không được hỗ trợ hoặc sẽ được khung Android chuyển mã, chẳng hạn như:

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()
}

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();
}

Trong ví dụ này, preferredFormats là danh sách các AudioFormat thực thể. Danh sách này được sắp xếp theo thứ tự ưu tiên nhất ở đầu và ít ưu tiên nhất ở cuối. getDirectProfilesForAttributes() trả về danh sách các đối tượng được hỗ trợ cho thiết bị âm thanh hiện được định tuyến bằng AudioAttributes.AudioProfile Danh sách các mục AudioFormat ưu tiên được lặp lại cho đến khi tìm thấy AudioProfile được hỗ trợ phù hợp. AudioProfile này được lưu trữ dưới dạng bestAudioProfile. Tốc độ lấy mẫu và mặt nạ kênh tối ưu được xác định từ bestAudioProfile. Cuối cùng, một thực thể AudioFormat thích hợp sẽ được tạo.

Tạo bản âm thanh

Ứng dụng nên sử dụng thông tin này để tạo một AudioTrack cho AudioFormat có chất lượng cao nhất được thiết bị âm thanh mặc định hỗ trợ (và có sẵn cho nội dung đã chọn).

Chặn các thay đổi của thiết bị âm thanh

Để chặn và phản ứng với các thay đổi của thiết bị âm thanh, ứng dụng nên:

Khi phát hiện thấy thay đổi của thiết bị âm thanh cho AudioTrack, ứng dụng sẽ kiểm tra các chức năng âm thanh đã cập nhật và nếu cần, hãy tạo lại AudioTrack bằng một AudioFormat khác. Hãy thực hiện việc này nếu định dạng mã hoá có chất lượng cao hơn hiện được hỗ trợ hoặc định dạng mã hoá được sử dụng trước đó không còn được hỗ trợ.

Mã mẫu

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)

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);
Trước
Phát ở chế độ nền trên thẻ Phát hiện nhạc
Tiếp
Điều chỉnh chế độ cài đặt màn hình