Enregistrer depuis le micro de la voiture

Vous pouvez utiliser les API CarAppService et CarAudioRecord de votre voiture pour accorder à votre application l'accès au micro de la voiture de l'utilisateur. Les utilisateurs doivent accorder à votre application l'autorisation d'accéder au micro de la voiture. Votre application peut enregistrer et traiter les entrées utilisateur.

Déclarer l'autorisation d'enregistrer

Avant d'enregistrer des données audio, vous devez d'abord déclarer l'autorisation d'enregistrement dans votre fichier AndroidManifest.xml et demander à l'utilisateur de l'accorder.

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

Vous devez demander l'autorisation d'enregistrer au moment de l'exécution. Pour en savoir plus sur la demande d'autorisations dans votre voiture, consultez Demander des autorisations.

Enregistrer un fichier audio

Une fois que l'utilisateur a accordé l'autorisation d'enregistrer, vous pouvez enregistrer l'audio et traiter l'enregistrement.

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

Acquérir la priorité audio

Lorsque vous enregistrez à partir du micro de la voiture, vous devez d'abord acquérir la priorité audio. Cela arrête tout média en cours. Si vous perdez la priorité audio, arrêtez l'enregistrement. Par exemple, pour acquérir la priorité audio :

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