AudioFocusSession

[wants]
[[wants.service]]
id = "com.amazon.audio.control"

/*
Requests audio focus, returns a AudioFocusStatus type when the promise is resolved

Assume session is an AudioFocusSession object
*\/
const attr: AudioFocusAttributes = {
    usage: audioSource.usage
};
const status = session.requestAudioFocusAsync(attr)
.then((status) => {return status;}).catch((error) => console.log(error));

let usage = session.getUsage(); // 必须等于请求焦点时使用的用法。

// 当授予音频焦点时触发
Creates a function and registers it in the Audio Focus Listener to execute this
function whenever an audio focus change happens and stores returned AudioFocusStatus
type in status after promise resolves

Assume session is an AudioFocusSession object
// 当释放音频焦点时触发

const callbackFunction = (event: any) => {
    switch (event.focusChange) {
        case AudioFocusChange.GRANTED:
            // 当应该调低音频（降低音量）时触发
            break;

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

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

        case AudioFocusChange.PAUSED:
            // 当应该将音频静音时触发（目前没有产品支持此功能）
            break;

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

        case AudioFocusChange.MUTED:
            // Triggered when audio should be muted (Currently no product supports this)
            break;
    }
};
const status = session.registerAudioFocusListenerAsync(callbackFunction)
.then((status) => {return status;}).catch((error) => console.log(error));

/*
Releases audio focus, returns a AudioFocusStatus type when the promise is resolved

Assume session is an AudioFocusSession object
*\/

const status = session.releaseAudioFocusAsync()
.then((status) => {return status;}).catch((error) => console.log(error));

/*
Requests audio focus, returns a AudioFocusStatus type when the promise is resolved

Assume session is an AudioFocusSession object
*\/
const attr: AudioFocusAttributes = {
    usage: audioSource.usage
};
const status = session.requestAudioFocusAsync(attr)
.then((status) => {return status;}).catch((error) => console.log(error));

/*
Unregisters callback function and stores returned AudioFocusStatus
type in status after promise resolves
*\/

const status = session.unregisterAudioFocusListenerAsync()
.then((status) => {return status;}).catch((error) => console.log(error));