Alexa Skill（C#）启动时无法播放音频问题求助

我之前也踩过类似的AudioPlayer坑，咱们一步步来排查解决：

1. 先确认Skill核心配置是否到位 #

• 必须开启AudioPlayer接口：登录Alexa开发者控制台，进入你的Skill的「Build」标签，找到「Interfaces」选项，确保AudioPlayer是启用状态——没开这个接口的话，Alexa根本不会识别音频播放指令。
• 检查音频文件的访问权限：
  • 音频链接必须是HTTPS协议，不能用HTTP或者内网地址；
  • 如果用S3存储音频，要给桶设置正确的CORS规则，同时确保音频文件的权限允许Alexa的用户代理访问（比如设置为公开可读，或者用IAM策略授权）。

2. 细查Alex.NET生成的JSON指令细节 #

哪怕你觉得JSON看起来正确，也有几个容易忽略的细节：

• 指令类型必须严格匹配：type字段必须是AudioPlayer.Play，大小写、标点都不能错；
• playBehavior参数选对：启动时播放建议用REPLACE_ALL，避免之前残留的播放队列干扰；
• 必选字段不能缺：token（唯一标识音频流）、offsetInMilliseconds（哪怕设为0也要明确写上），少一个都可能导致播放失败。

你可以把Lambda返回的JSON和官方示例对比，比如官方标准的Play指令结构是这样的：

{
  "version": "1.0",
  "sessionAttributes": {},
  "response": {
    "directives": [
      {
        "type": "AudioPlayer.Play",
        "playBehavior": "REPLACE_ALL",
        "audioItem": {
          "stream": {
            "token": "audio-token-001",
            "url": "https://example.com/audio.mp3",
            "offsetInMilliseconds": 0
          }
        }
      }
    ],
    "shouldEndSession": true
  }
}

3. 验证Lambda代码的返回逻辑 #

确保你用Alex.NET构建的SkillResponse没有逻辑问题，比如正确的代码写法应该是这样的：

using Alexa.NET;
using Alexa.NET.Response;
using Alexa.NET.Response.AudioPlayer;

// 处理LaunchRequest的方法
public SkillResponse HandleLaunchRequest()
{
    var playDirective = new AudioPlayerPlayDirective
    {
        PlayBehavior = PlayBehavior.ReplaceAll,
        AudioItem = new AudioItem
        {
            Stream = new AudioItemStream
            {
                Url = "https://你的公网音频链接.mp3",
                Token = "unique-audio-token",
                OffsetInMilliseconds = 0
            }
        }
    };

    var response = ResponseBuilder.Empty();
    response.Response.Directives.Add(playDirective);
    response.Response.ShouldEndSession = true; // 播放音频时建议结束会话

    return response;
}

注意：如果同时设置了OutputSpeech和AudioPlayer指令，Alexa会先播报文本再播放音频；如果只需要播放，用ResponseBuilder.Empty()生成空响应再添加指令更稳妥。

4. 用日志和测试工具定位问题 #

• 查看Alexa控制台的「Test」标签：发送启动指令后，检查「JSON Output」里的返回结构，确认directives数组在response对象下，没有嵌套错误；
• 查看Lambda的CloudWatch日志：搜索有没有报错信息，比如音频链接无法访问、序列化失败等；
• 测试设备状态：确保Echo设备网络正常、未静音、音量足够，有时候问题可能出在设备端而非代码。

5. 最后几个容易踩的小坑 #

• 音频文件格式要合规：支持MP3（128kbps/44.1kHz最佳）、M4A等格式，避免用不兼容的编码；
• 启动Intent关联正确：确认LaunchRequest确实指向了你的Lambda函数，有时候配置变更会导致关联失效；
• 音频时长不能过短：如果音频小于1秒，Alexa可能会忽略播放请求，建议用一段5秒以上的音频测试。

内容的提问来源于stack exchange，提问作者RADobson