在基于Node.js的Amazon Alexa技能中添加开场铃声的实现方法咨询

嗨，我来帮你解决这个问题！要在你的Alexa技能里实现先播放开场铃声再播放主MP3流的需求，其实用Alexa AudioPlayer的队列功能或者播放完成事件监听就能搞定，下面给你两种具体的实现方案：

方案一：使用队列自动衔接播放 #

这种方法会把主MP3流加入播放队列，当铃声播放完毕后，Alexa会自动开始播放主流，无需额外监听事件，实现起来更简单。

修改你的代码 #

首先，你需要定义铃声的固定URL，然后在返回响应时，先添加播放铃声的指令，再用ENQUEUE指令把主流加入队列：

// 定义你的开场铃声URL
const jingleUrl = "你的固定铃声MP3地址";

// 生成唯一的token，区分铃声和主流
function jingleToken() {
    return 'jingle-unique-token';
}

function mainStreamToken() {
    return 'main-stream-unique-token';
}

const LaunchRequestHandler = {
    canHandle(handlerInput) {
        return Alexa.getRequestType(handlerInput.requestEnvelope) === 'LaunchRequest'
            || (Alexa.getRequestType(handlerInput.requestEnvelope) === 'IntentRequest'
                && Alexa.getIntentName(handlerInput.requestEnvelope) === 'PlayStationIntent');
    },
    handle(handlerInput) {
        const speakOutput = messages.welcome;

        return handlerInput.responseBuilder
            .speak(speakOutput)
            // 先播放开场铃声，用REPLACE_ALL清空之前的播放队列
            .addAudioPlayerPlayDirective("REPLACE_ALL", jingleUrl, jingleToken(), 0)
            // 将主MP3流加入队列，铃声播放完后自动播放
            .addAudioPlayerPlayDirective("ENQUEUE", url, mainStreamToken(), 0, jingleToken())
            .getResponse();
    }
};

关键说明 #

• REPLACE_ALL：用于清空之前的播放队列，确保从铃声开始播放
• ENQUEUE：将主流添加到当前播放队列的末尾，最后一个参数jingleToken()指定了这个队列项的前一个token，确保顺序正确
• 每个音频都需要唯一的token，用来区分不同的播放内容，避免冲突

方案二：监听播放完成事件触发主流播放 #

如果你需要在铃声播放完后做一些额外逻辑（比如记录日志、更新用户数据），可以选择监听PlaybackFinished事件，在事件处理函数中触发主流播放。

步骤1：添加PlaybackFinished事件处理器 #

const PlaybackFinishedRequestHandler = {
    canHandle(handlerInput) {
        return Alexa.getRequestType(handlerInput.requestEnvelope) === 'AudioPlayer.PlaybackFinished'
            && handlerInput.requestEnvelope.request.token === jingleToken();
    },
    handle(handlerInput) {
        // 铃声播放完毕，开始播放主MP3流
        return handlerInput.responseBuilder
            .addAudioPlayerPlayDirective("REPLACE_ALL", url, mainStreamToken(), 0)
            .getResponse();
    }
};

步骤2：修改LaunchRequestHandler只播放铃声 #

const LaunchRequestHandler = {
    canHandle(handlerInput) {
        return Alexa.getRequestType(handlerInput.requestEnvelope) === 'LaunchRequest'
            || (Alexa.getRequestType(handlerInput.requestEnvelope) === 'IntentRequest'
                && Alexa.getIntentName(handlerInput.requestEnvelope) === 'PlayStationIntent');
    },
    handle(handlerInput) {
        const speakOutput = messages.welcome;

        return handlerInput.responseBuilder
            .speak(speakOutput)
            .addAudioPlayerPlayDirective("REPLACE_ALL", jingleUrl, jingleToken(), 0)
            .getResponse();
    }
};

关键说明 #

• 要确保你的技能已经注册了AudioPlayer.PlaybackFinished事件的处理权限
• 通过判断token来确认是铃声播放完成，避免误触发主流播放

注意事项 #

• 你的铃声和主流MP3都必须是公开可访问的HTTPS URL，Alexa无法访问本地或者HTTP的音频资源
• 音频格式要符合Alexa的要求：建议使用MP3格式，采样率44.1kHz，比特率128kbps
• 确保铃声的时长不要过长，符合Alexa技能的用户体验规范

备注：内容来源于stack exchange，提问作者Paeddy