@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();