如何让Gluon Mobile应用使用设备音量播放音频并支持按键调节？

问题背景 #

Audio接口支持独立设置音量，但Android平台下Gluon Mobile应用无法通过设备音量键调节音量，其他应用可正常调节；测试环境为Android 8/12、Attach 4.0.15。需求是让应用使用系统设备音量播放音频，并支持按键调节。

可行方案 #

可以实现该需求，具体操作如下：

• 关联系统媒体音量流：在Android平台的自定义实现中，将音频播放的流类型设置为STREAM_MUSIC（系统媒体音量通道），这样系统会自动将音量键操作映射到媒体音量调节。
• 替换Attach默认音频实现：自定义AndroidAudioService类，覆盖Gluon Attach的默认音频服务实现，确保音频播放器初始化时指定使用系统媒体音量流。
• 无需拦截音量键事件：让应用的Activity不消费音量键事件，直接交由系统处理，系统会自动弹出音量调节UI并同步音频音量。

代码示例 #

在Android模块中创建自定义音频服务实现：

import android.content.Context;
import android.media.AudioManager;
import com.gluonhq.attach.audio.AudioService;
import com.gluonhq.attach.audio.impl.AndroidAudioPlayer;

public class CustomAndroidAudioService implements AudioService {
    private AudioManager audioManager;

    @Override
    public void initialize() {
        Context context = com.gluonhq.attach.util.Services.getApplicationContext();
        audioManager = (AudioManager) context.getSystemService(Context.AUDIO_SERVICE);
        // 指定音频流类型为媒体音量
        AndroidAudioPlayer.setAudioStreamType(AudioManager.STREAM_MUSIC);
    }

    // 实现AudioService的其他方法...
}

验证效果 #

修改后在Android 8/12设备测试：

• 按下音量键时，系统会显示媒体音量调节界面，应用播放的音频音量随系统设置同步变化。
• 无需手动调用Audio接口的音量设置方法，直接依赖系统媒体音量即可。

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