車のマイクから録音します

車の CarAppServiceCarAudioRecord API を使用して、ユーザーの車のマイクへのアクセス権をアプリに付与できます。ユーザーは、車のマイクにアクセスするための権限をアプリに付与する必要があります。アプリは、アプリ内でユーザー入力を録音して処理できます。

録音の権限を宣言する

音声を録音する前に、まず AndroidManifest.xml で録音の権限を宣言し、ユーザーに権限の付与をリクエストする必要があります。

<manifest ...>
   ...
   <uses-permission android:name="android.permission.RECORD_AUDIO" />
   ...
</manifest>

録音の権限は実行時にリクエストする必要があります。車内で権限をリクエストする方法について詳しくは、権限をリクエストするをご覧ください。

音声を記録する

ユーザーが録音の権限を付与すると、音声を録音して録音を処理できます。

val carAudioRecord = CarAudioRecord.create(carContext)
carAudioRecord.startRecording()

val data = ByteArray(CarAudioRecord.AUDIO_CONTENT_BUFFER_SIZE)
while (carAudioRecord.read(data, 0, CarAudioRecord.AUDIO_CONTENT_BUFFER_SIZE) >= 0) {
    // Use data array
    // Potentially call carAudioRecord.stopRecording() if your processing finds end of speech
}
carAudioRecord.stopRecording()

音声フォーカスを取得する

車載マイクから録音する場合は、まず音声フォーカスを取得する必要があります。 これにより、進行中のメディアが停止します。音声フォーカスを失った場合は、録音を停止します。たとえば、音声フォーカスを取得するには、次のようにします。

val carAudioRecord = CarAudioRecord.create(carContext)

// Take audio focus so that user's media is not recorded
val audioAttributes = AudioAttributes.Builder()
    .setContentType(AudioAttributes.CONTENT_TYPE_SPEECH)
    // Use the most appropriate usage type for your use case
    .setUsage(AudioAttributes.USAGE_ASSISTANCE_NAVIGATION_GUIDANCE)
    .build()

val audioFocusRequest =
    AudioFocusRequest.Builder(AudioManager.AUDIOFOCUS_GAIN_TRANSIENT_EXCLUSIVE)
        .setAudioAttributes(audioAttributes)
        .setOnAudioFocusChangeListener { state: Int ->
            if (state == AudioManager.AUDIOFOCUS_LOSS) {
                // Stop recording if audio focus is lost
                carAudioRecord.stopRecording()
            }
        }
        .build()

val audioManager = carContext.getSystemService(AudioManager::class.java)
if (audioManager == null ||
    audioManager.requestAudioFocus(audioFocusRequest)
    != AudioManager.AUDIOFOCUS_REQUEST_GRANTED
) {
    // Don't record if the focus isn't granted
    return
}

carAudioRecord.startRecording()
// Process the audio and abandon the AudioFocusRequest when done