文档导航 iOS
本页目录

Talk SDK for iOS 快速接入

概述

游密实时语音SDK(Talk SDK)是游密科技公司旗下的一款专注于为开发者提供实时语音技术和服务的云产品。我们的研发团队来自腾讯,其中不少是拥有10年以上音视频经验的专家,专业专注;我们的服务端节点部署遍布全球,为用户提供高效稳定的实时云服务,且弹性可扩展,真正做到亿级支撑、毫秒级延迟、通话清晰流畅、按需取用,为用户带来优质的通话体验。通过Talk SDK,能够让您轻松实现游戏内语音通话、主播、指挥、组队等多项功能。

四步集成

Step1:注册账号

在游密官网注册游密账号,并登录。

Step2:添加游戏,获取Appkey

在控制台添加游戏,添加成功后 在网页左边的游戏栏会增加一个对应的应用,点击进去就可以获得接入需要的Appkey、Appsecret。

Step3:下载Talk SDK包体

根据游戏使用的游戏引擎与开发语言,在下载入口下载对应的SDK包体。

Step4:调试集成

iOS 平台集成Talk SDK:集成方法

单频道自由通话基本流程

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

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

TEXT
// 所在对象实现 VoiceEngineCallback,完整协议方法见 API 手册。
- (YouMeErrorCode_t)startTalk {
    return [[YMVoiceService getInstance] initSDK:self appkey:@"YOUR_APP_KEY"
        appSecret:@"YOUR_APP_SECRET" regionId:RTC_DEFAULT_SERVER serverRegionName:@""];
}

- (void)onYouMeEvent:(YouMeEvent_t)event errcode:(YouMeErrorCode_t)error
             roomid:(NSString *)room param:(NSString *)param {
    if (event == YOUME_EVENT_INIT_OK) {
        YouMeErrorCode_t ret = [[YMVoiceService getInstance] joinChannel:@"user1"
            channelID:@"team1" userRole:YOUME_USER_TALKER_FREE singleMode:true checkRoomExist:false];
        if (ret != YOUME_SUCCESS) { /* 处理同步进房错误。 */ }
    } else if (event == YOUME_EVENT_JOIN_OK) {
        [[YMVoiceService getInstance] setMicrophoneMute:false];
        [[YMVoiceService getInstance] setSpeakerMute:false];
        [[YMVoiceService getInstance] setVolume:70];
    } else if (event == YOUME_EVENT_INIT_FAILED || event == YOUME_EVENT_JOIN_FAILED) {
        // 处理 error,停止后续流程。
    }
}
// 离开时 leaveChannelAll,等待离房完成后 unInit。

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