אתם יכולים להשתמש בממשקי ה-API CarAppService ו-CarAudioRecord של הרכב כדי להעניק לאפליקציה גישה למיקרופון של הרכב. המשתמשים צריכים לתת לאפליקציה הרשאה לגשת למיקרופון של הרכב. האפליקציה יכולה להקליט ולעבד קלט של משתמשים באפליקציה.
הצהרה על הרשאה להקלטה
לפני שמקליטים אודיו, צריך קודם להצהיר על ההרשאה להקלטה ב-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