# 跑通 API 示例项目 (/zh-CN/realtime-media/rtc/get-started/run-demo/harmonyos)
> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).
声网提供开源示例项目演示 RTC SDK 的 API 使用示例,以帮助开发者更好地理解和运用声网 SDK 的功能。本文介绍如何快速跑通 HarmonyOS NEXT 示例项目,体验实时音视频功能。
HarmonyOS} href="https://gitee.com/agoraio-community/API-Examples/tree/main/HarmonyOS" />
HarmonyOS} href="https://github.com/Shengwang-Community/API-Examples/tree/main/HarmonyOS" />
## 前提条件 [#前提条件-5]
- DevEco Studio 5.1.0 Release 及以上版本,已包含所需的 HarmonyOS SDK。
- 运行 API 12 及以上版本 HarmonyOS 的设备。
- 已通过授权的华为开发者账号。可在[华为开发者联盟](https://developer.huawei.com/consumer/cn/)注册账号。
- 两台支持鸿蒙 NEXT 的设备,建议使用 Mate 60 Pro 及更高性能的设备。
- 可以访问互联网的计算机。
- 一个有效的声网账号以及声网项目。请参考[开通 RTC 服务](/zh-CN/realtime-media/rtc/build/setup-and-access/enable-service)从声网控制台获得以下信息:
- App ID:声网随机生成的字符串,用于识别你的项目。
- App 证书(可选):用于生成 Token 的字符串。如果你的项目启用了允许仅 App ID 加入,则不需要获取该字段。
## 操作步骤 [#操作步骤-5]
### 获取示例项目 [#获取示例项目-5]
1. 运行以下命令,将 Gitee 或 GitHub 示例项目仓库的 `main` 分支克隆至本地。
```shell
# 克隆 Gitee 仓库
git clone git@gitee.com:agoraio-community/API-Examples.git
# 克隆 GitHub 仓库
git clone git@github.com:Shengwang-Community/API-Examples.git
```
2. 该仓库中包含声网 RTC SDK 所有 Native 平台的示例项目,其中 HarmonyOS 平台的 API 使用示例位于 `/HarmonyOS` 路径下。
3. 运行以下命令,进入克隆的仓库目录,下载并校验 v4.6.3 视频 SDK,将 `AgoraRtcSdk.har` 安装到示例项目的 `entry/libs` 目录中:
```shell
cd API-Examples
bash HarmonyOS/APIExample/prepare_sdk.sh
```
### 配置示例项目 [#配置示例项目-5]
1. 用 DevEco Studio 打开 `/API-Examples/HarmonyOS/APIExample` 文件夹。
2. 为你的项目设置自动签名。
点击 **File** > **Project Structure...** > **Project** > **SigningConfigs**,在窗口中勾选 **Support HarmonyOS** 和 **Automatically generate signature**。点击界面提示的 **Sign In** 并使用华为帐号登录。等待自动签名完成后,点击 **OK** 即可。
2. 设置 App ID 和 App 证书
打开 `HarmonyOS/APIExample/entry/src/main/ets/common/KeyCenter.ets` 文件,在 `YOUR APP ID` 和 `YOUR APP CERTIFICATE` 中填入你从声网控制台获取的 App ID 和 App 证书。
```arkts
// 把 <#Your App ID#> 替换成你的 App ID,并加引号,如 "xxxxxx"
export const AppID: string = YOUR APP ID
// 把 #YOUR Certificate# 替换成你的 App 证书,并加引号,如 "xxxxxx";该字段可为空
export const AppCertificate: string = YOUR APP CERTIFICATE
```
### 编译并运行示例项目 [#编译并运行示例项目-4]
1. 开启鸿蒙设备的开发者选项,打开 USB 调试选项,通过 USB 连接线将鸿蒙设备接入电脑,并在顶部菜单栏中勾选你的设备。
2. 点击 按钮,开始编译。
3. 编译成功后,你的设备上会出现 **APIExample** App。
4. 打开 **APIExample** App,选择你想体验的场景。以**视频互动直播**为例,输入频道名(如 `09666`),并点击 **Join** 加入频道。
5. 为更好地体验各种音视频互动场景,你可以邀请一位朋友使用另一台设备运行该示例项目(需确保 App ID 不变)。以**视频互动直播**为例,你们输入相同的频道名并加入频道后,你们会看到彼此,并听到彼此的声音。