更新记录

1.0.0（2026-03-05）

• 支持音频输出通道监听与控制（听筒/外放）
• 支持音频播放状态监听（中断/恢复）
• 兼容 Android 与 iOS

平台兼容性

uni-app(5.01)

uni-app x(5.01)

hl-audio-monitor

音频状态监控插件，支持监听音频播放状态变化（如被中断、恢复）以及音频输出通道（听筒、扬声器、耳机、蓝牙）的切换。

快速上手

1. 引入插件

import * as audioMonitor from '@/uni_modules/hl-audio-monitor';

2. 初始化与监听

// 在页面加载时初始化
onMounted(() => {
    // 初始化监控环境
    audioMonitor.initMonitor();

    // 监听输出通道变更（0:未知, 1:听筒, 2:扬声器, 3:耳机, 4:蓝牙）
    audioMonitor.startRouteMonitor((route) => {
        console.log('当前音频通道：', route);
    });

    // 监听播放状态（0:空闲, 1:播放中, 2:暂停, 3:被中断）
    audioMonitor.startPlayStateMonitor((state) => {
        console.log('当前播放状态：', state);
    });
});

// 在页面卸载时清理
onUnmounted(() => {
    audioMonitor.stopRouteMonitor();
    audioMonitor.stopPlayStateMonitor();
    audioMonitor.destroyMonitor();
});

3. 切换音频通道

// 切换到听筒
audioMonitor.setAudioRoute(1);

// 切换到扬声器
audioMonitor.setAudioRoute(2);

// 切换到耳机（需物理连接）
audioMonitor.setAudioRoute(3);

// 切换到蓝牙（需已连接）
audioMonitor.setAudioRoute(4);

// 获取当前通道
const currentRoute = audioMonitor.getAudioRoute();

API 说明