Talk SDK for Harmony 快速接入

sdk名称：游密实时语音SDK

包名：@youme/voice_engine

版本号：3.1.0

更新日期：2026-04-01

md5值：f062cfa42775afefa81ca2def7e07d87

开发者：游密科技（深圳）有限公司

隐私政策：SDK隐私政策

合规指引：SDK合规使用指南

四步集成

Step1：注册账号

在游密官网注册游密账号。

Step2：添加游戏，获取Appkey

在控制台添加游戏，获得接入需要的Appkey、Appsecret。

Step3：导入Talk SDK for Harmony包体

两种方法导入HAR包：

1. 手动导入

下载youme_voice_engine_3.0.15.har包，放到⼯程libs中。在⼯程中配置引⽤：

JSON

{
"dependencies": {
"@youme/voice_engine":"file:./libs/youme_voice_engine_3.0.15.har"
}
}

2. ohpm导入

在⼯程中配置：

JSON

{
"dependencies": {
"@youme/voice_engine":"3.0.15"
}
}

运⾏命令：

TEXT

ohpm install @youme/voice_engine

Step4：根据文档调试集成

Talk SDK for Harmony 插件使用指南
Talk SDK for Harmony 主要场景流程
Talk SDK for Harmony API接口手册

单频道自由通话基本流程

先注册回调，初始化返回成功后等待初始化成功事件，再加入频道；收到进房成功后设置麦克风、扬声器及音量增益。同步返回失败或收到失败事件时停止后续步骤。退出时先离房，等待完成后反初始化。

下面的示例代码演示单频道自由通话。替换 AppKey、AppSecret、用户和频道 ID，并完成本平台 SDK 导入及权限配置；回调对象应保持存活。

TypeScript

// 在业务持有的 YouMeRtcAPI 实例上先注册回调，再初始化。
const rtc = YouMeRtcAPI.Instance();
rtc.SetEventCallback((event: YouMeRtcEvent, err: YouMeRtcErrorCode, channel: string, param: string) => {
  if (event === YouMeRtcEvent.YOUME_EVENT_INIT_OK) {
    const ret = rtc.JoinChannel('user1', 'team1', YouMeRtcUserRole.YOUME_USER_TALKER_FREE, true, false);
    if (ret !== YouMeRtcErrorCode.YOUME_SUCCESS) { /* 处理同步进房错误。 */ }
  } else if (event === YouMeRtcEvent.YOUME_EVENT_JOIN_OK) {
    rtc.SetMicMute(false);
    rtc.SetSpeakerMute(false);
    rtc.SetVolume(70);
  } else if (event === YouMeRtcEvent.YOUME_EVENT_INIT_FAILED || event === YouMeRtcEvent.YOUME_EVENT_JOIN_FAILED) {
    // 处理 err，停止后续流程。
  }
});
const ret = rtc.Init('YOUR_APP_KEY', 'YOUR_APP_SECRET', YouMeRtcServerRegion.RTC_DEFAULT_SERVER, '');
// ret 非成功时立即处理；成功表示开始初始化，继续等待回调。
// 离开时 rtc.LeaveChannelAll()，等离房完成后 rtc.UnInit()。

回调注册方式及基本通话流程见使用指南，接口的五部分说明见 API 手册。初始化、进房和离房均等待相应完成事件后继续。

文档目录