VoiceInputIndicator הוא רכיב Jetpack Compose Glimmer שמציג למשתמש את פעילות הצליל. אתם יכולים להשתמש ברכיב הזה כדי לקבל קלט קולי או אודיו אחר, ולספק משוב חזותי שמראה שהאפליקציה מתעדת אודיו.
הרכיב הזה הוא רכיב חזותי בלבד. הוא לא מקליט אודיו או מעבד נתונים מהמיקרופון בעצמו. במקום זאת, הוא מגיב ל-level של אודיו שהאפליקציה מספקת, שמציג ייצוג חזותי של עוצמת האודיו.
בקשת הרשאות מוקרנות
כדי לתעד נתוני אודיו שיפעילו את האינדיקטור, האפליקציה צריכה את ההרשאה Manifest.permission.RECORD_AUDIO.
כשאתם מפתחים חוויות מציאות רבודה למשקפיים עם תצוגה פנימית, חשוב לוודא שאתם מבקשים הרשאות בצורה נכונה גם במכשיר וגם במשקפיים. משתמשים ב-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.primary. -
modifier: ה-modifierהרגיל של Compose שצריך להחיל על האינדיקטור.
רכיבים קשורים
אם ממשק המשתמש שלכם דורש שהאינדיקטור יישב בתוך קונטיינר רקע גלוי, השתמשו ב-ContainedVoiceInputIndicator. החלופה הזו מבטיחה שסרגלי האינדיקטורים יהיו שקופים, כך שהקונטיינר שברקע יופיע דרכם.