# 跑通 API 示例项目 (/zh-CN/realtime-media/rtc/get-started/run-demo/mini-program) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). 声网在 GitHub 上提供一个开源的小程序实时音视频示例项目。在搭建自己的小程序项目前,你可以下载体验或参考源代码。本文介绍如何配置环境并跑通该示例项目。 Agora-Miniapp-Tutorial} href="https://github.com/AgoraIO/Agora-Miniapp-Tutorial" /> ## 前提条件 [#前提条件-6] 开始前,请确保你的开发环境满足如下条件: - 一个经过企业认证的微信小程序账号。在调试小程序示例项目过程中,需要使用 live-pusher 和 live-player 组件。只有特定行业的认证企业账号才可以使用这两个组件。详见[小程序官网文档](https://developers.weixin.qq.com/miniprogram/dev/component/live-player.html)。 - 下载并安装最新版本的[微信开发者工具](https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html)。 - 参考[开通 RTC 服务](/zh-CN/realtime-media/rtc/build/setup-and-access/enable-service)在控制台创建项目、获取 App ID 和临时 Token,并[开通小程序服务](/zh-CN/realtime-media/rtc/build/setup-and-access/enable-service#mini-program-service)。 :::warning[注意] 临时 Token 的有效期是 24 小时。Token 过期会引起项目编译失败。 ::: - 至少一台安装有微信 App 的移动设备。 ## 操作步骤 [#操作步骤-6] ### 1. 获取小程序组件权限 [#1-获取小程序组件权限] 在[微信公众平台](https://mp.weixin.qq.com/)的小程序**开发**选项中,切换到**接口设置**页签,打开**实时播放音视频流**和**实时录制音视频流**的开关。 ![打开音视频开关](https://web-cdn.agora.io/docs-files/1605069073929) ### 2. 配置服务器域名 [#2-配置服务器域名] 在小程序的开发设置里,将如下域名配到服务器域名里,其中 **request 合法域名**区域填入以 https 开头的域名;**socket 合法域名**区域填入以 `wss` 开头的域名。 如果你使用的 SDK 为 **v2.5.3** 或更高版本,你需要在 **request 合法域名**及 **socket 合法域名**中添加以下域名: ```shell wss://miniapp.agoraio.cn https://uap-ap-web-1.agora.io https://uap-ap-web-2.agoraio.cn https://uap-ap-web-3.agora.io https://uap-ap-web-4.agoraio.cn https://report-ad.agoralab.co https://rest-argus-ad.agoralab.co ``` ![添加域名](https://web-cdn.agora.io/docs-files/1638759333663) 如果你使用的 SDK 为 v2.4.6 或更低版本,你需要在 request 合法域名及 socket 合法域名中添加以下域名: ```shell wss://miniapp.agoraio.cn https://miniapp-1.agoraio.cn https://miniapp-2.agoraio.cn https://miniapp-3.agoraio.cn https://miniapp-4.agoraio.cn ``` ### 3. 获取示例项目并集成小程序 SDK [#3-获取示例项目并集成小程序-sdk] 参考如下步骤获取小程序示例项目,并将小程序 SDK 集成到示例项目中。 1. 下载 [Agora-Miniapp-Tutorial](https://github.com/AgoraIO/Agora-Miniapp-Tutorial) 仓库。 2. 下载最新版[微信小程序 SDK](/zh-CN/realtime-media/rtc/reference/downloads) 并解压。 3. 将解压后的 SDK 包更名为 **mini-app-sdk-production.js**,然后将其复制到 `Agora-Miniapp-Tutorial-master/lib` 路径下。 4. 打开 `Agora-Miniapp-Tutorial-master/utils/config.js` 文件,然后在 `const APPID` 行后添加你获取到的声网项目 App ID。 5. 打开 `Agora-Miniapp-Tutorial-master/pages/meeting/meeting.js` 文件,将 `client.join` 和 `client.rejoin` 方法中的 `undefined` 参数修改为你获取到的临时 Token,确保使用双引号("")包裹该参数值。 ### 4. 运行示例项目 [#4-运行示例项目] 参考如下步骤在微信开发者工具中运行小程序示例项目。 1. 打开**微信开发者工具**,点击小程序界面的 **+**。 2. 在弹出的界面中选择导入项目页签,然后在目录一栏中选中小程序示例项目在本地的存储路径,填入你**微信小程序的 App ID**,然后点击**导入**。 ![导入小程序](https://web-cdn.agora.io/docs-files/1605070114544) 3. 加载成功后,微信开发者工具上会出现小程序示例项目的界面。为保证体验效果,我们建议选择**真机调试**。点击右上角的真机调试,工具界面会出现一个真机调试的二维码。 ![真机调试](https://web-cdn.agora.io/docs-files/1605070164900) 4. 使用移动端微信 App 扫描二维码,进入手机调试界面。填入**房间名**,然后点击**加入房间**。在弹出的对话框中点击**确定**,表示作为主播加入频道。稍等片刻,就可以在小程序的界面看到本地的视频画面。请确保此处填入的房间名,和生成临时 Token 时填入的频道名是一致的。 ## 常见问题 [#常见问题] 通常客户端初始化失败,会伴随错误码 901 或 903。我们建议你检查确认如下项: - 填入 `config.js` 文件中的 App ID,确认已在控制台开启了小程序服务。 - 你的微信小程序账号需要在开发界面配置域名,且打开了**实时播放音视频流**和**实时录制音视频流**的开关。 - 生成临时 Token 时使用的频道名,需要和运行小程序时填入的频道名一致。