Alexa技能开发：如何通过预签名URL播放私有S3桶MP4视频？

核心问题分析 #

你遇到的问题是音频SSML能正常使用S3预签名URL，但APL视频无法生效，主要差异在于APL对URL的处理逻辑、S3请求的权限要求和CORS配置与音频场景不同。以下是具体解决步骤：

具体解决方案 #

1. 修正预签名URL的生成逻辑 #

确保生成预签名URL时，明确指定HTTP方法、MIME类型和足够的有效期，避免播放中途URL过期：

// 在util.js中调整getS3PreSignedUrl实现
const AWS = require('aws-sdk');
const s3 = new AWS.S3();

exports.getS3PreSignedUrl = (key) => {
  const params = {
    Bucket: process.env.S3_BUCKET_NAME,
    Key: key,
    Expires: 3600, // 设置1小时有效期，按需调整
    ResponseContentType: 'video/mp4', // 明确指定视频MIME类型
    ResponseContentDisposition: 'inline' // 允许浏览器/设备直接播放而非下载
  };
  return s3.getSignedUrl('getObject', params);
};

2. 移除不必要的URL转义 #

APL数据源不需要像SSML那样对&进行XML转义，直接使用原始预签名URL即可：

// 去掉转义处理，直接赋值
var videoUrl = Util.getS3PreSignedUrl("Media/safari.mp4");

3. 配置S3桶的CORS规则 #

Alexa设备发起视频请求时需要跨域权限，在S3桶的CORS配置中添加以下规则：

<CORSConfiguration>
  <CORSRule>
    <AllowedOrigin>*</AllowedOrigin> <!-- 可限制为*.alexa.com以提升安全性 -->
    <AllowedMethod>GET</AllowedMethod>
    <AllowedMethod>HEAD</AllowedMethod>
    <AllowedHeader>*</AllowedHeader>
    <MaxAgeSeconds>3000</MaxAgeSeconds>
  </CORSRule>
</CORSConfiguration>

4. 验证APL模板的视频绑定 #

确保你的VideoDocument模板正确绑定数据源中的视频URL，示例配置如下：

{
  "type": "Video",
  "source": "${videoPlayerTemplateData.properties.videoSources}",
  "autoplay": true,
  "controlType": "${videoPlayerTemplateData.properties.videoControlType}",
  "width": "100%",
  "height": "100%"
}

5. 测试预签名URL有效性 #

直接在浏览器中访问生成的预签名URL，确认能正常播放MP4视频。如果无法访问，检查S3对象的权限、预签名参数（Bucket名称、Key路径）是否正确。

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