如何在PlaceAutocompleteFragment中添加语音搜索功能？

我刚好做过类似的需求，其实不用太复杂，咱们可以通过以下几步快速给PlaceAutocompleteFragment加上语音搜索的麦克风图标，实现语音输入替代手动输入的功能：

1. 获取Fragment内部的SearchView #

PlaceAutocompleteFragment的核心输入控件是一个SearchView，我们可以通过它的内置ID找到这个控件。在你的Activity或Fragment的初始化代码中添加：

val autocompleteFragment = supportFragmentManager.findFragmentById(R.id.autocomplete_fragment) as PlaceAutocompleteFragment
// 获取内部的SearchView，ID是Google Places SDK内置的
val searchView = autocompleteFragment.view?.findViewById<SearchView>(R.id.places_autocomplete_search_input)

2. 给SearchView添加麦克风图标并绑定点击事件 #

找到SearchView后，我们可以在它的输入框右侧添加麦克风图标，并设置点击事件触发语音识别：

searchView?.apply {
    // 隐藏默认的搜索图标（可选，根据你的UI需求调整）
    setSearchIconDrawable(null)
    
    // 创建麦克风图标按钮
    val micIcon = resources.getDrawable(R.drawable.ic_mic, theme)
    val micButton = ImageButton(context).apply {
        setImageDrawable(micIcon)
        setPadding(16, 0, 16, 0)
        setOnClickListener {
            // 先检查录音权限，再启动语音识别
            checkRecordPermissionAndStartVoiceRecognition()
        }
    }
    
    // 将麦克风按钮添加到SearchView的输入区域
    val searchPlate = findViewById<View>(androidx.appcompat.R.id.search_plate)
    (searchPlate as LinearLayout).addView(micButton)
}

3. 实现语音识别逻辑 #

接下来需要编写语音识别的核心代码，包括启动语音识别Intent、处理返回结果：

3.1 启动语音识别的方法 #

private val VOICE_RECOGNITION_REQUEST_CODE = 1001
private val RECORD_AUDIO_PERMISSION_CODE = 1002

private fun checkRecordPermissionAndStartVoiceRecognition() {
    if (ContextCompat.checkSelfPermission(this, Manifest.permission.RECORD_AUDIO) 
        != PackageManager.PERMISSION_GRANTED) {
        // 请求录音权限
        ActivityCompat.requestPermissions(
            this, 
            arrayOf(Manifest.permission.RECORD_AUDIO), 
            RECORD_AUDIO_PERMISSION_CODE
        )
    } else {
        // 权限已授予，启动语音识别
        startVoiceRecognition()
    }
}

private fun startVoiceRecognition() {
    val intent = Intent(RecognizerIntent.ACTION_RECOGNIZE_SPEECH).apply {
        putExtra(RecognizerIntent.EXTRA_LANGUAGE_MODEL, RecognizerIntent.LANGUAGE_MODEL_FREE_FORM)
        putExtra(RecognizerIntent.EXTRA_PROMPT, "请说出你要搜索的地点")
    }
    try {
        startActivityForResult(intent, VOICE_RECOGNITION_REQUEST_CODE)
    } catch (e: ActivityNotFoundException) {
        Toast.makeText(this, "当前设备不支持语音识别功能", Toast.LENGTH_SHORT).show()
    }
}

3.2 处理语音识别结果 #

在Activity中重写onActivityResult方法，把识别出的文本填入搜索框：

override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
    super.onActivityResult(requestCode, resultCode, data)
    if (requestCode == VOICE_RECOGNITION_REQUEST_CODE && resultCode == Activity.RESULT_OK) {
        val results = data?.getStringArrayListExtra(RecognizerIntent.EXTRA_RESULTS)
        results?.firstOrNull()?.let { spokenText ->
            // 将语音识别结果填入搜索框并触发自动完成
            val autocompleteFragment = supportFragmentManager.findFragmentById(R.id.autocomplete_fragment) as PlaceAutocompleteFragment
            val searchView = autocompleteFragment.view?.findViewById<SearchView>(R.id.places_autocomplete_search_input)
            searchView?.setQuery(spokenText, true)
        }
    }
}

3.3 处理权限请求结果 #

重写onRequestPermissionsResult方法，处理录音权限的请求结果：

override fun onRequestPermissionsResult(requestCode: Int, permissions: Array<out String>, grantResults: IntArray) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults)
    if (requestCode == RECORD_AUDIO_PERMISSION_CODE) {
        if (grantResults.isNotEmpty() && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            startVoiceRecognition()
        } else {
            Toast.makeText(this, "需要授予录音权限才能使用语音搜索", Toast.LENGTH_SHORT).show()
        }
    }
}

4. 配置权限 #

最后别忘了在AndroidManifest.xml中添加录音权限：

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

注意事项 #

• 确保你的项目已经正确集成了Google Places SDK（既然你已经实现了自动完成，这一步应该没问题）
• 麦克风图标ic_mic需要你自己添加到项目的drawable资源中，或者使用系统自带的图标
• 直接操作PlaceAutocompleteFragment的内部布局依赖于SDK的内部ID，虽然目前这个ID是稳定的，但如果未来SDK更新有变动，可能需要调整。如果追求更稳定的方案，可以考虑使用AutocompleteSupportFragment并自定义整个搜索布局。

内容的提问来源于stack exchange，提问作者Piyush-Ask Any Difference