@amazon-devices/keplerscript-audio-lib

    "@amazon-devices/keplerscript-audio-lib": "~2.0.18"

import { 
    AudioManager,
    AudioPlaybackStream,
    AudioPlaybackStreamBuilder,
    AudioFocusManager,
    AudioFocusSession
} from '@amazon-devices/keplerscript-audio-lib';

// 设置媒体音量
await AudioManager.setVolumeAsync(AudioVolumeType.VOLUME_TYPE_MEDIA, 75, AudioVolumeFlags.VOLUME_FLAG_SHOW_UI);

// 获取当前音量
const volume = await AudioManager.getVolumeAsync(AudioVolumeType.VOLUME_TYPE_MEDIA);

// 创建播放流
const builder = new AudioPlaybackStreamBuilder();
builder.setAudioConfig({
    sampleRate: AudioSampleRate.SAMPLE_RATE_44_1_KHZ,
    channelMask: AudioChannelMask.CHANNEL_STEREO,
    format: AudioSampleFormat.FORMAT_PCM_16_BIT
});
builder.setAudioAttributes({
    contentType: AudioContentType.CONTENT_TYPE_MUSIC,
    usage: AudioUsageType.USAGE_MEDIA,
    flags: AudioFlags.FLAG_NONE
});

const playbackStream = await builder.buildAsync();
await playbackStream.startAsync();

// 创建并请求音频焦点
const focusSession = await AudioFocusManager.createAudioFocusSessionAsync();
await focusSession.requestAudioFocusAsync({
    usage: AudioUsageType.USAGE_MEDIA
});

// 注册焦点变化
await focusSession.registerAudioFocusListenerAsync((focusChange) => {
    console.log('焦点已变化：', focusChange);
});

// 注册系统范围的音频事件
await AudioManager.registerAudioEventObserverAsync((event) => {
    // 事件对象会根据事件类型包含不同的属性
    switch (event.audioEvent) {
        case AudioEvent.DEVICE_STATE_UPDATE:
            // 当音频设备的连接状态发生变化时触发
            // 参数：
            // - device： AudioDevice枚举值
            // - role： AudioRole枚举值
            // - connect：表示设备是已连接 (true) 还是已断开连接 (false) 的布尔值
            console.log(`设备 ${event.device}，具有角色 ${event.role} ${event.connect ? '已连接' : '已断开连接'}`);
            break;

        case AudioEvent.VOLUME_UPDATE:
            // 当任何音频类型的音量发生变化时触发
            // 参数：
            // - type： AudioVolumeType枚举值
            // - volume：数字 (0-100)
            console.log('此项的音量已更改：', event.type, '更改为：', event.volume);
            break;

        case AudioEvent.GLOBAL_VOLUME_MUTE_UPDATE:
            // 当全局静音状态发生变化时触发
            // 参数：
            // - mute：表示系统是否静音的布尔值
            console.log('全局静音更新为状态：', event.mute);
            break;

        case AudioEvent.SERVER_DOWN:
            // 当音频服务器变得不可用时触发
            console.log('音频服务器已关闭');
            break;

        case AudioEvent.SERVER_UP:
            // 当音频服务器变得可用时触发
            console.log('音频服务器已启动');
            break;

        case AudioEvent.AUDIO_USAGE_STATE_CHANGE:
            // 当音频使用状态发生变化时触发
            // 参数：
            // - usage： AudioUsageType枚举值
            // - active：表示使用是否处于活动状态的布尔值
            console.log('使用情况：', event.usage);
            console.log('活动状态：', event.active);
            break;

        case AudioEvent.MIC_MUTE_STATE_UPDATE:
            // 当麦克风静音状态发生变化时触发
            // 参数：
            // - state：表示麦克风是否静音的布尔值
            console.log('麦克风静音状态已更改：', event.muteState);
            break;

        case AudioEvent.VOLUME_MUTE_UPDATE:
            // 当特定音量类型的音量静音状态发生变化时触发
            // 参数：
            // - volumeType： AudioVolumeType枚举值
            // - mute：表示类型是否静音的布尔值
            console.log('音量类型：', event.volumeType);
            console.log('静音状态：', event.muteState);
            break;

        case AudioEvent.TELEPHONY_MUTE_UPDATE:
            // 当电话静音状态发生变化时触发
            // 参数：
            // - deviceType： AudioDevice枚举值
            // - address：表示设备地址的字符串
            // - deviceName：表示设备名称的字符串
            // - mute：表示电话是否静音的布尔值
            console.log('电话静音更新！：');
            console.log('设备类型：', event.deviceType);
            console.log('设备地址：', event.deviceAddress);
            console.log('设备名称：', event.deviceName);
            console.log('设备静音状态：', event.muteState);
            break;
    }
});

// 清理
await AudioManager.unregisterAudioEventObserverAsync();

const playbackStream = await builder.buildAsync();

await playbackStream.registerEventObserverAsync((event) => {
    switch (event.type) {
        case AudioPlaybackEvent.DIED:
            // 当播放流变得不可用时触发
            break;

        case AudioPlaybackEvent.RECOVERED:
            // 当播放流从终止状态恢复时触发
            break;

        case AudioPlaybackEvent.STOPPED:
            // 当播放流停止时触发
            break;

        case AudioPlaybackEvent.MUTE_STATE_UPDATE:
            // 当流的静音状态发生变化时触发
            // 参数：
            // - muted：表示流是否静音的布尔值
            console.log('静音状态：', event.muteState);
            break;

        case AudioPlaybackEvent.FRAME_UNDERRUN:
            // 发生缓冲区欠载时触发
            // 参数：
            // - size：表示欠载大小的数字（以帧为单位）
            console.log('欠载发生次数：', event.underrunCount);
            break;
    }
});

// 清理
await playbackStream.unregisterEventObserverAsync();

const focusSession = await AudioFocusManager.createAudioFocusSessionAsync();

await focusSession.registerAudioFocusListenerAsync((focusChange) => {
    switch (focusChange.type) {
        case AudioFocusChange.GRANTED:
            // 当授予音频焦点时触发
            break;

        case AudioFocusChange.RELEASED:
            // 当释放音频焦点时触发
            break;

        case AudioFocusChange.DUCKED:
            // 当应该调低音频（降低音量）时触发
            break;

        case AudioFocusChange.PAUSED:
            // 当应该暂停音频时触发
            break;

        case AudioFocusChange.STOPPED:
            // 当应该停止音频时触发
            break;
    }
});

// 清理
await focusSession.unregisterAudioFocusListenerAsync();