本文档适用于通过插件方式接入火山引擎微信小程序拉流 SDK，帮助您快速完成初始化配置、组件集成与播放调试。

环境要求 #

• 小程序基础库 2.12.3 及以上版本，推荐使用最新稳定版。
• 微信开发者工具 1.06.2209040 及以上版本，推荐使用最新稳定版。

前提条件 #

视频直播配置 #

• 已在视频直播控制台域名添加，并配置 CNAME。
• 已添加证书、开启 HTTPS 配置，并生成 FLV/RTMP 协议拉流地址。
• 已创建 Web 应用、绑定基础版 License 并获取 App ID。详见获取 SDK License。该 App ID 用于标识您的小程序接入身份。

  tip

  基础版 License 免费，但使用小程序 SDK 观看直播时，仍会产生下行拉流费用。详见计费概述。

微信小程序配置 #

• 已注册并认证微信小程序，主体类型为中国大陆地区的非个人主体。
• 已配置插件方式集成支持的服务类目。
• 已在微信小程序后台 > 开发与服务 > 开发管理 > 开发设置 > 服务器域名中：
  • 添加日志上报域名 https://mcs.zijieapi.com 至 downloadFile 合法域名列表。
  • 添加封面图 CDN 域名 https://mcs.zijieapi.com 至 request 合法域名列表。
  • 配置 FLV/RTMP 拉流地址等其他必要的业务域名。

操作步骤 #

1. 添加插件 #

1. 登录微信公众平台，进入设置 > 第三方设置。
2. 在插件管理中，点击添加插件。
3. 搜索插件名称：小火播放器，选择插件并完成添加。插件信息如下：
   • 插件 AppID：wx7bea91b3573fbc41
   • 当前版本：1.0.0

2. 配置插件信息 #

1. 在项目根目录的 app.json 文件中配置插件信息。

{
  "plugins": {
    "ve-live-plugin": {
      "version": "1.0.0",
      "provider": "wx7bea91b3573fbc41"
    }
  }
}

2. 配置完成后，重新编译小程序项目以加载插件。

3. 引入组件 #

1. 在页面的配置文件（如 pages/index/index.json）中声明组件引用路径。

// 文件路径：/pages/index/index.json
{
  "usingComponents": {
    "ve-live-player": "plugin://ve-live-plugin/ve-live-player"
  }
}

2. 保存后刷新页面。

4. 使用组件 #

在页面的 WXML 文件中使用组件，以下示例展示通过 src 设置拉流地址并启用自动播放。

<!-- 文件路径：/pages/index/index.wxml -->
<ve-live-player autoplay src="{{src}}" />

关键参数说明：

• src：请填写您在火山引擎控制台中生成的 FLV/RTMP 拉流地址。
• autoplay：开启自动播放（需已配置合法域名）

接入其他功能 #

视频直播微信小程序拉流 SDK 支持封面图设置、事件监听、报错监听、自适应容器、日志上报等功能，接入方法请参考功能接入或 API 参考。