オーディオ機能

Android TV は、テレビのスピーカー、HDMI ホーム シネマ、Bluetooth など、複数の同時オーディオ出力をサポートしています。これらのデバイスは、さまざまなエンコード（ドルビー デジタル プラス、DTS、PCM など）、サンプリング レート、チャンネルをサポートしています。HDMI 接続のテレビは多くの形式をサポートしていますが、Bluetooth は PCM のみをサポートしています。

再生中に利用可能なオーディオ デバイスとルーティングが変更されることがあります。たとえば、ユーザーが HDMI をホットプラグしたり、Bluetooth を接続したり、設定を変更したりする可能性があります。アプリは、新しいデバイスの機能を使用して再生を継続できるように、適切に対応する必要があります。サポートされていない形式では、エラーが発生したり、無音になったりすることがあります。

デバイスの機能に基づいて最適なエクスペリエンスを実現するために、複数のエンコードを提供します。たとえば、Dolby Digital がサポートされている場合は 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
}

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

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() は、指定された AudioAttributes を持つ現在ルーティングされているオーディオ機器でサポートされている AudioProfile オブジェクトのリストを返します。一致するサポートされている AudioProfile が見つかるまで、優先 AudioFormat アイテムのリストが反復処理されます。この AudioProfile は bestAudioProfile として保存されます。最適なサンプルレートとチャンネル マスクは bestAudioProfile から決定されます。最後に、適切な AudioFormat インスタンスが作成されます。

音声トラックを作成する

アプリは、この情報を使用して、デフォルトのオーディオ機器でサポートされている（選択したコンテンツで利用可能な）最高品質の AudioFormat の AudioTrack を作成する必要があります。

オーディオ機器の変更をインターセプト

音声デバイスの変更をインターセプトして対応するには、アプリは次の処理を行う必要があります。

  • API レベルが 24 以上の場合は、OnRoutingChangedListener を追加して、オーディオ機器の変更（HDMI、Bluetooth など）をモニタリングします。
  • API レベル 23 の場合は、AudioDeviceCallback を登録して、利用可能なオーディオ機器のリストの変更を受け取ります。
  • API レベル 21 と 22 では、HDMI プラグ イベントをモニタリングし、ブロードキャストからの追加データを使用します。
  • また、API 23 より前のデバイスでは AudioDeviceCallback がまだサポートされていないため、BluetoothDevice の状態変化をモニタリングする BroadcastReceiver も登録します。

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)

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);
前へ
「この曲なに？」カードでのバックグラウンド再生
次へ
ディスプレイの設定を調整する