VoiceInputIndicator คือคอมโพเนนต์ Jetpack Compose Glimmer ที่แสดงกิจกรรมเสียงให้ผู้ใช้เห็น คุณสามารถใช้คอมโพเนนต์นี้เพื่อรับอินพุตเสียงหรือเสียงอื่นๆ และแสดงภาพเพื่อแสดงว่าแอปของคุณกำลังบันทึกเสียงอยู่
คอมโพเนนต์นี้เป็นองค์ประกอบภาพเท่านั้น โดยจะไม่บันทึกเสียงหรือประมวลผลข้อมูลไมโครโฟนด้วยตัวเอง แต่จะตอบสนองต่อlevelเสียงที่แอปของคุณให้มา ซึ่งจะแสดงภาพความเข้มของเสียง
ขอสิทธิ์ที่คาดการณ์ไว้
หากต้องการบันทึกข้อมูลเสียงเพื่อขับเคลื่อนสัญญาณบอกสถานะ แอปของคุณต้องมีสิทธิ์ Manifest.permission.RECORD_AUDIO
เมื่อสร้างประสบการณ์ Augmented สำหรับแว่นตาที่มีจอแสดงผล โปรดตรวจสอบว่าคุณขอสิทธิ์อย่างถูกต้องทั้งในอุปกรณ์และแว่นตา ใช้ ProjectedActivityCompat.requestPermissions เพื่อแจ้งผู้ใช้
ดูข้อมูลเพิ่มเติมเกี่ยวกับการขอสิทธิ์ในสภาพแวดล้อมที่ฉายภาพได้ที่หัวข้อขอสิทธิ์เข้าถึงฮาร์ดแวร์
บันทึกและปรับเสียงให้สอดคล้องตามมาตรฐาน
VoiceInputIndicator ต้องมี Float ระหว่าง 0.0f ถึง 1.0f เพื่อแสดงความหนักของเสียงเป็นภาพ เนื่องจากตัวบ่งชี้ทำงานเป็นคอมโพเนนต์ภาพเท่านั้นและไม่ได้บันทึกเสียง แอปของคุณจึงต้องตรวจสอบไมโครโฟนอย่างสม่ำเสมอและสตรีมระดับเสียงไปยังพารามิเตอร์ level ของตัวบ่งชี้
แม้ว่าจะมีหลายวิธีในการบันทึกข้อมูลเสียง แต่วิธีหนึ่งคือการใช้ API SpeechRecognizer เมื่อใช้ SpeechRecognizer คุณสามารถบันทึกการอัปเดตระดับเสียงแบบเรียลไทม์ได้โดยใช้ Callback RecognitionListener.onRmsChanged ซึ่งจะให้ระดับเสียงเป็นเดซิเบล rmsdB
เนื่องจากค่าดิบนี้มักจะอยู่ระหว่าง 0 ถึง 10 คุณจึงต้องปรับค่าเอาต์พุตให้อยู่ในช่วง 0.0f ถึง 1.0f ที่ต้องการ คุณสามารถเก็บระดับที่ปรับให้สอดคล้องกันนี้ไว้ในตัวแปรสถานะเพื่ออัปเดตสัญญาณบอกสถานะอย่างต่อเนื่อง
ต่อไปนี้คือตัวอย่างการใช้ RecognitionListener เพื่ออัปเดตตัวแปรสถานะ
// Example state variable to hold the normalized level (0.0 to 1.0) // that the VoiceInputIndicator component expects. val audioLevel = MutableStateFlow(0f) // Initialize the Android SpeechRecognizer val speechRecognizer = SpeechRecognizer.createSpeechRecognizer(context) // Listener to capture speech events and audio level changes val listener = object : RecognitionListener { override fun onRmsChanged(rmsdB: Float) { // Normalize raw dB level to a 0.0-1.0 range. // Android SpeechRecognizer's rmsdB typically ranges from 0 to ~10. audioLevel.value = ((rmsdB - 1f) / 9f).coerceIn(0f, 1f) } // ... Implement other required RecognitionListener methods ... override fun onReadyForSpeech(params: Bundle?) {} override fun onBeginningOfSpeech() {} override fun onEndOfSpeech() {} override fun onError(error: Int) {} override fun onResults(results: Bundle?) {} override fun onPartialResults(partialResults: Bundle?) {} override fun onEvent(eventType: Int, params: Bundle?) {} override fun onBufferReceived(buffer: ByteArray?) {} } // Attach the listener to the recognizer speechRecognizer.setRecognitionListener(listener) // Create an intent to specify the recognition model and behavior val intent = Intent(RecognizerIntent.ACTION_RECOGNIZE_SPEECH).apply { putExtra(RecognizerIntent.EXTRA_LANGUAGE_MODEL, RecognizerIntent.LANGUAGE_MODEL_FREE_FORM) } // Begin listening for audio input speechRecognizer.startListening(intent)
ผสานรวมสัญญาณบอกสถานะการป้อนข้อมูลด้วยเสียง
เมื่อสตรีมเสียงได้รับการปรับให้เป็นมาตรฐานและแสดงเป็นสถานะอย่างถูกต้องแล้ว คุณสามารถส่งสตรีมเสียงไปยัง VoiceInputIndicator ได้โดยตรง
@Composable fun VoiceInputExample(modifier: Modifier) { // Collect the flow as Compose State so the UI reacts to changes in real-time. val currentLevel by audioLevel.collectAsState() VoiceInputIndicator( // The VoiceInputIndicator component provides a visual "pulse" or indicator // that changes based on the 'level' lambda, which returns a Float between 0.0 and 1.0. level = { currentLevel }, modifier = modifier ) }
พารามิเตอร์การปรับแต่ง
VoiceInputIndicator มีพารามิเตอร์บางอย่างเพื่อปรับแต่งลักษณะการทำงานและรูปลักษณ์ ดังนี้
level: ฟังก์ชันที่แสดงผลFloatซึ่งแสดงระดับของเสียงที่ป้อน โดยมีตั้งแต่0.0สำหรับเสียงเงียบไปจนถึง1.0สำหรับเสียงที่ดังที่สุดindicatorColor: สีของแถบตัวบ่งชี้ โดยค่าเริ่มต้น ระบบจะใช้สีหลักจากธีม Glimmer โปรดดูGlimmerTheme.colors.primarymodifier:modifierของ Compose มาตรฐานที่จะใช้กับตัวบ่งชี้
คอมโพเนนต์ที่เกี่ยวข้อง
หาก UI ของคุณกำหนดให้ต้องวางตัวบอกสถานะไว้ภายในคอนเทนเนอร์พื้นหลังที่มองเห็นได้ ให้ใช้ ContainedVoiceInputIndicator ทางเลือกนี้ช่วยให้มั่นใจได้ว่าแถบตัวบ่งชี้จะโปร่งใส ซึ่งช่วยให้คอนเทนเนอร์พื้นหลังแสดงผ่านได้