QT QML iOS端音量按键事件拦截失效问题咨询

问题原因 #

你写的这段QML代码本身写法没有问题，在iOS无法生效是两类系统层面的限制导致的：

• iOS对物理音量按键的默认控制权在系统，普通应用的上层UI事件链默认收不到音量按键的触发事件，所以Qt Quick的Keys事件处理器没有办法捕获到对应的按压信号
• Qt for iOS的底层适配默认没有做音量按键事件的转发逻辑，不会把系统层面的音量按键行为传递到QML的事件体系中

解决方法 #

你需要额外做iOS平台的专属适配，不需要修改原有的安卓端逻辑：

• 配置应用的音频会话权限
  你需要通过Objective-C++混写，或者直接修改Qt生成的iOS工程原生代码，给应用激活支持响应音量按键的音频会话，核心代码如下：

  #import <AVFoundation/AVFoundation.h>
  
  AVAudioSession *audioSession = [AVAudioSession sharedInstance];
  [audioSession setCategory:AVAudioSessionCategoryPlayAndRecord withOptions:AVAudioSessionCategoryOptionMixWithOthers error:nil];
  [audioSession setActive:YES error:nil];
  

  这段代码放在应用启动的iOS平台专属初始化分支里执行即可。

• 监听系统音量变化通知转发到QML
  即使配置了音频会话，QML的Keys.onVolumeUpPressed/Keys.onVolumeDownPressed在iOS还是不会触发，你需要在原生层监听AVSystemController_SystemVolumeDidChangeNotification系统通知，获取到音量按键的按压行为后，通过Qt的信号槽机制转发到QML层，调用你已经写好的volumeUp()/volumeDown()方法即可。

• 可选：屏蔽系统音量弹窗
  如果你不需要显示系统自带的音量调节弹窗，可以在应用的UI层级添加一个不可见的MPVolumeView组件，即可隐藏系统弹窗。

注意：如果你的应用要上架App Store，需要确保使用音量按键的功能和音频控制相关，不符合苹果审核规则的用法会被驳回。

内容的提问来源于stack exchange，提问作者cagnulein