Android Fragment中setOnKeyListener监听音量键翻页失效问题
问题描述
我正在开发一款诗歌类阅读应用,基本功能已开发完成,现在需要实现音量键翻页的交互:按下音量上键时触发nextPage()方法跳转至下一页。当前遇到的问题是:按下音量上键后nextPage方法完全没有执行。
我的项目采用单MainActivity承载多Fragment的架构,我在ShowPoemBodyFragment的onViewCreated方法中给布局根视图绑定了按键监听,但监听完全不生效,也不知道其他可行的实现方案。
对应问题的Fragment代码
class ShowPoemBodyFragment : Fragment(){ private val viewModel: PoemBodyViewModel by viewModels() private var binding: FragmentShowPoemsBinding by autoCleared() private var shared: SharedPreferences? = null private var mId by Delegates.notNull<Int>() private var fId by Delegates.notNull<Int>() private var size by Delegates.notNull<Int>() private var sharedBackground: SharedPreferences? = null private var sharedImage: SharedPreferences? = null private val poemAdapter = PoemBodyAdapter() override fun onCreateView( inflater: LayoutInflater, container: ViewGroup?, savedInstanceState: Bundle? ): View { binding = FragmentShowPoemsBinding.inflate(inflater, container, false) return binding.root } override fun onViewCreated(view: View, savedInstanceState: Bundle?) { super.onViewCreated(view, savedInstanceState) // 原无效监听代码 binding.root.setOnKeyListener(View.OnKeyListener { _, keyCode, _ -> if (keyCode == KeyEvent.KEYCODE_VOLUME_UP) { nextPage() return@OnKeyListener true } else { false } }) binding.poemBodyRecyclerView.adapter = poemAdapter fId = requireArguments().getString("id")?.toIntOrNull()!! size = requireArguments().getString("size")?.toIntOrNull()!! viewModel.getPoemById(fId.toString()) Hawk.put("lastSeen", fId.toString()) Log.i("pomeid", fId.toString()) mId = fId obserViewModel() var fav: Int? = null binding.markFavShowPoem.setOnClickListener { if (fav == 1) { fav = 0 binding.markFavShowPoem.setImageResource(R.drawable.ic_star) } else { fav = 1 binding.markFavShowPoem.setImageResource(R.drawable.ic_star_bold) shared = context?.getSharedPreferences("shared_fav", Context.MODE_PRIVATE) val editor: SharedPreferences.Editor = shared!!.edit() editor.putString("id", mId.toString()) Toast.makeText(context, "به لیست علاقه مندی ها اضافه شد", Toast.LENGTH_SHORT).show() editor.apply() } } binding.textOption.setOnClickListener { SubDialogFragmentPopUp().show( requireActivity().supportFragmentManager, "popUp" ) } if (mId == mId + size) { binding.nextPage.visibility = View.INVISIBLE } else { binding.nextPage.setOnClickListener { nextPage() } } if (mId == fId) { binding.previousPage.visibility = View.INVISIBLE } else { binding.previousPage.setOnClickListener{ mId -= 1 viewModel.getPoemById(mId.toString()) Hawk.put("lastSeen", mId.toString()) Log.i("pomeid", mId.toString()) obserViewModel() } } // 背景设置逻辑 sharedBackground = context?.getSharedPreferences("shared_background_color", Context.MODE_PRIVATE) val bbcg: Boolean = sharedBackground!!.getBoolean("bbcg", false) if (bbcg) { val color: Int = sharedBackground!!.getInt("background_color", 0) view.background_show_poem_body.setBackgroundColor(color) } // 封面图设置逻辑 sharedImage = context?.getSharedPreferences("imagePoem", Context.MODE_PRIVATE) val image: String? = sharedImage!!.getString("image", "") context?.let { Glide.with(this) .load(image) .centerCrop() .error(R.drawable.ic_launcher_foreground) .into(view.image_poem_adapter) } } fun obserViewModel() { viewModel.poemBody.observe(viewLifecycleOwner, Observer { when (it.status) { SUCCESS -> it.data?.let { poemAdapter.updatePoems(it) } ERROR -> { it.message?.let { requireActivity().toast(it) } } LOADING -> { } } }) } private fun nextPage(){ mId += 1 viewModel.getPoemById(mId.toString()) Hawk.put("lastSeen", mId.toString()) Log.i("pomeid", mId.toString()) obserViewModel() } }
监听失效的核心原因
- 视图
OnKeyListener的响应前提是视图获得焦点:当前布局内包含RecyclerView、可点击按钮等会抢占焦点的控件,根视图默认不会获取焦点,根本接收不到任何按键事件 - 音量键是系统优先处理的按键:系统默认会把音量键事件交给音量调节模块处理,事件分发流程最先经过所属Activity的派发环节,不会直接落到Fragment的普通视图监听上
可落地的实现方案
针对单Activity多Fragment的架构,采用在Activity层统一拦截按键事件,转发给当前活跃的Fragment处理的方案,稳定性远高于视图焦点监听,不会因为焦点变化失效。
修改步骤:
- 删除
onViewCreated中给根视图设置的无效setOnKeyListener代码 - 将
ShowPoemBodyFragment中的翻页方法从私有改为公开,方便Activity调用 - 在
MainActivity中重写onKeyDown方法,拦截音量键事件,判断当前活跃Fragment为诗歌正文页时,消费事件并调用对应翻页方法
代码修改示例
首先调整Fragment的方法访问权限:
// 原私有nextPage()改为公开 fun nextPage(){ mId += 1 viewModel.getPoemById(mId.toString()) Hawk.put("lastSeen", mId.toString()) Log.i("pomeid", mId.toString()) obserViewModel() } // 原上一页点击逻辑抽为独立方法 fun previousPage(){ mId -= 1 viewModel.getPoemById(mId.toString()) Hawk.put("lastSeen", mId.toString()) Log.i("pomeid", mId.toString()) obserViewModel() }
然后在MainActivity中添加按键拦截逻辑:
class MainActivity : AppCompatActivity() { override fun onKeyDown(keyCode: Int, event: KeyEvent?): Boolean { // 获取当前容器内的活跃Fragment,替换为自己项目的容器视图id val currentFragment = supportFragmentManager.findFragmentById(R.id.fragment_container) // 判断当前是诗歌正文页时,处理音量键 if (currentFragment is ShowPoemBodyFragment) { when (keyCode) { // 拦截音量上键,跳转下一页 KeyEvent.KEYCODE_VOLUME_UP -> { // 仅处理首次按下事件,避免长按连续翻页 if (event?.repeatCount == 0) { currentFragment.nextPage() } return true // 消费事件,阻止系统默认的音量调节 } // 可拓展:拦截音量下键,跳转上一页 KeyEvent.KEYCODE_VOLUME_DOWN -> { if (event?.repeatCount == 0) { currentFragment.previousPage() } return true } } } // 非目标页面时,走系统默认按键逻辑 return super.onKeyDown(keyCode, event) } }
注意事项:
- 代码中
R.id.fragment_container需要替换为自己项目中承载Fragment的容器视图id- 如果不需要屏蔽系统音量调节,只需要在按下音量键时翻页、不改变系统音量,只要不return true,让事件继续分发即可
内容的提问来源于stack exchange,提问作者AbbasLotfinasab
相关产品推荐
相关产品推荐

