Khả năng về âm thanh

Các thiết bị Android TV có thể kết nối cùng lúc nhiều đầu ra âm thanh: loa TV, rạp chiếu phim tại nhà có kết nối 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 HDMI hỗ trợ nhiều phương thức mã hoá, trong khi tai nghe Bluetooth đã kết nối thường chỉ hỗ trợ PCM.

Danh sách thiết bị âm thanh có sẵn và thiết bị âm thanh được định tuyến cũng có thể thay đổi bằng cách cắm nóng 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ì khả 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 các ứng dụng cần thích ứng linh hoạt với 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 cùng các tính năng của thiết bị. Việc đầu ra sai định dạng âm thanh có thể dẫn đến lỗi hoặc không phát âm thanh.

Các ứng dụng có khả năng xuất cùng một nội dung ở nhiều phương thức mã hoá để mang lại 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á Dolby Digital sẽ được phát nếu TV hỗ trợ, 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ợ Dolby Digital. Bạn có thể tìm thấy danh sách các bộ giải mã Android tích hợp sẵn dùng để chuyển đổi luồng âm thanh thành PCM trong phần Định dạng nội dung nghe nhìn được hỗ trợ.

Tại thời điểm phát, ứng dụng truyền trực tuyến phải tạo một AudioTrack có AudioFormat phù hợp nhất mà thiết bị âm thanh đầu ra hỗ trợ.

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

Các ứ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 sẽ phát âm thanh. Ví dụ: đó có thể là bản nhạc được mã hoá PCM tắt tiếng và an toàn, chỉ dùng để xác định thiết bị được định tuyến và khả năng âm thanh của thiết bị.

Nhận các kiểu mã hoá được hỗ trợ

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

Kiểm tra cấu hình và định dạng âm thanh được hỗ trợ

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

Một số thiết bị Android có khả năng hỗ trợ các phương thức mã hoá ngoài những phương thức mà thiết bị âm thanh đầu ra hỗ trợ. Bạn cầ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 sang một định dạng mà thiết bị âm thanh đầu ra hỗ trợ. Sử dụng isDirectPlaybackSupported() để kiểm tra 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 mong đợi

Android 13 (API cấp 33) đã ra mắt các tuyến âm thanh dự kiến. Bạn có thể dự đoán rằng thiết bị sẽ hỗ trợ thuộc tính âm thanh 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:

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
}

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 xem hồ sơ nào được hỗ trợ để phát nội dung nghe nhìn trực tiếp thông qua thiết bị âm thanh hiện được định tuyến. Quy tắc này không bao gồm mọi hồ sơ không được hỗ trợ hoặc có thể được chuyển mã bằng khung Android:

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

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 thực thể AudioFormat. Thứ tự này được sắp xếp theo thứ tự ưu tiên nhất ở vị trí đầu tiên và thứ tự ít được ưu tiên nhất ở cuối cùng. getDirectProfilesForAttributes() trả về danh sách các đối tượng AudioProfile được hỗ trợ cho thiết bị âm thanh hiện được định tuyến bằng AudioAttributes đã cung cấp. Danh sách các mục AudioFormat ưu tiên sẽ đượ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 tối ưu và mặt nạ kênh được xác định từ ngày 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

Các ứng dụng nên sử dụng thông tin này để tạo AudioTrack cho AudioFormat chất lượng cao nhất mà 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 đối với thiết bị âm thanh

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

• Đối với các cấp độ API bằng hoặc lớn hơn 24, hãy thêm OnRoutingChangedListener để theo dõi các thay đổi đối với thiết bị âm thanh (HDMI, Bluetooth, v.v.).
• Đối với API cấp 23, hãy đăng ký AudioDeviceCallback để nhận các thay đổi trong danh sách thiết bị âm thanh có sẵn.
• Đối với API cấp 21 và 22, hãy theo dõi các sự kiện cắm HDMI và sử dụng dữ liệu bổ sung từ các thông báo truyền tin.
• Ngoài ra, hãy đăng ký BroadcastReceiver để theo dõi các thay đổi về trạng thái BluetoothDevice cho các thiết bị thấp hơn API 23, vì AudioDeviceCallback chưa được hỗ trợ.

Khi phát hiện thấy thay đổi về thiết bị âm thanh đối với 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 phương thức mã hoá chất lượng cao hơn hiện được hỗ trợ hoặc phương thức mã hoá dùng trước đó không còn được hỗ trợ nữa.

Mã mẫu

// 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)

// 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);