1、整体准备工作 · 3、即时通信Demo快速入门 即通通信Demo...

30
目录 目录 .................................................................................................................................................. 1 1、整体准备工作............................................................................................................................. 2 1.1 注册腾讯云帐号................................................................................................................ 2 1.2 开通服务............................................................................................................................ 2 1.3 创建应用............................................................................................................................ 3 1.3.1 填写基本信息......................................................................................................... 3 1.3.2 填写所属平台......................................................................................................... 3 1.4 帐号集成............................................................................................................................ 4 1.5 下载 SDK 集成 ................................................................................................................... 4 2、应用配置..................................................................................................................................... 5 3、即时通信 Demo 快速入门......................................................................................................... 7 3.1 ios demo 使用说明............................................................................................................. 8 3.1.1 SDK 的参数配置 ...................................................................................................... 8 3.1.2 demo 使用简介 ....................................................................................................... 9 3.2 android demo 使用说明................................................................................................... 14 3.2.1 SDK 的参数配置 .................................................................................................... 14 3.2.2 demo 使用简介 ..................................................................................................... 15 4、音视频 Demo 快速入门........................................................................................................... 19 4.1 ios demo 使用说明........................................................................................................... 19 4.1.1 SDK 的参数配置 .................................................................................................... 19 4.1.2 demo 使用简介 ..................................................................................................... 19 4.2 android demo 使用说明................................................................................................... 24 4.2.1 双人音视频 demo ................................................................................................ 24 4.2.2 多人音视频 demo ................................................................................................ 28

Transcript of 1、整体准备工作 · 3、即时通信Demo快速入门 即通通信Demo...

Page 1: 1、整体准备工作 · 3、即时通信Demo快速入门 即通通信Demo 包含了一个类似手机QQ 的IM 功能,包括以下功能: 帐号(手机号码,字符串帐号)注册,登录,设置帐号昵称

目录

目录 .................................................................................................................................................. 1

1、整体准备工作 ............................................................................................................................. 2

1.1 注册腾讯云帐号 ................................................................................................................ 2

1.2 开通服务............................................................................................................................ 2

1.3 创建应用............................................................................................................................ 3

1.3.1 填写基本信息 ......................................................................................................... 3

1.3.2 填写所属平台 ......................................................................................................... 3

1.4 帐号集成............................................................................................................................ 4

1.5 下载 SDK 集成 ................................................................................................................... 4

2、应用配置..................................................................................................................................... 5

3、即时通信 Demo 快速入门 ......................................................................................................... 7

3.1 ios demo 使用说明 ............................................................................................................. 8

3.1.1 SDK 的参数配置 ...................................................................................................... 8

3.1.2 demo 使用简介 ....................................................................................................... 9

3.2 android demo 使用说明 ................................................................................................... 14

3.2.1 SDK 的参数配置 .................................................................................................... 14

3.2.2 demo 使用简介 ..................................................................................................... 15

4、音视频 Demo 快速入门 ........................................................................................................... 19

4.1 ios demo 使用说明 ........................................................................................................... 19

4.1.1 SDK 的参数配置 .................................................................................................... 19

4.1.2 demo 使用简介 ..................................................................................................... 19

4.2 android demo 使用说明 ................................................................................................... 24

4.2.1 双人音视频 demo ................................................................................................ 24

4.2.2 多人音视频 demo ................................................................................................ 28

Page 2: 1、整体准备工作 · 3、即时通信Demo快速入门 即通通信Demo 包含了一个类似手机QQ 的IM 功能,包括以下功能: 帐号(手机号码,字符串帐号)注册,登录,设置帐号昵称

1、整体准备工作

在使用腾讯音视频云通信服务之前,您首先需要在腾讯云官网申请接入,腾讯音视频云通信

接入流程如下:

1.1 注册腾讯云帐号

您需要注册腾讯云帐号并完成相关资料的提交,完成注册后,进入下一流程-申请开通音视

频云通信服务。

1.2 开通服务

访问腾讯云视频解决方案介绍页 http://www.qcloud.com/solution_video.html ,点击页面底部

的“免费开通”按钮,如下图:

您将访问视频解决方案开通申请页,如下图:

请正确填写该页面所需信息,便于我们针对您的业务现状提供更优质的服务;点击该页面底

Page 3: 1、整体准备工作 · 3、即时通信Demo快速入门 即通通信Demo 包含了一个类似手机QQ 的IM 功能,包括以下功能: 帐号(手机号码,字符串帐号)注册,登录,设置帐号昵称

部的“提交申请”后,完成视频服务申请,进入下一流程-创建应用

1.3 创建应用

1.3.1 填写基本信息

在应用开发前,需要先在音视频云通信控制台创建应用,首先填写应用基本信息,如下图:

1.3.2 填写所属平台

然后,填写应用所属平台信息,如下图:

【说明】

1. iOS 应用正式发布时,请务必填写 Bundle Identifier,否则无法实现消息推送;如果创建

应用时未填写,后续可以在应用详情中填写。

2. iOS 应用正式发布时,请务必添加 iOS 证书,否则无法实现消息推送;如果创建应用时

未填写,后续可以在应用详情中填写。

3. 填写完应用所属平台,点击页面底部“创建应用”的按钮,完成应用创建。

Page 4: 1、整体准备工作 · 3、即时通信Demo快速入门 即通通信Demo 包含了一个类似手机QQ 的IM 功能,包括以下功能: 帐号(手机号码,字符串帐号)注册,登录,设置帐号昵称

创建应用后,会给开发者分配一个应用标识:SdkAppId,如下图:

接下来进入下一流程-帐号集成。

1.4 帐号集成

【说明】

1. 应用名称与帐号名称的区别在于,一个帐号类型下面可以有多个应用,比如帐号名称为

“天天娱乐”,应用的名称就可以有“天天扑克”和“天天地主”。

2. 集成模式分为独立模式和托管模式,详情请点击了解集成模式。

完成帐号集成后,进入下一流程-下载 SDK 集成。

1.5 下载 SDK 集成

腾讯音视频云通信申请流程到此结束,您可以下载音视频通信 SDK 或者即通通信 SDK 进行

代码了。

Page 5: 1、整体准备工作 · 3、即时通信Demo快速入门 即通通信Demo 包含了一个类似手机QQ 的IM 功能,包括以下功能: 帐号(手机号码,字符串帐号)注册,登录,设置帐号昵称

2、应用配置

在介绍 Demo 之前,先介绍如何对应用进行配置,比如帐号的集成模式,公私钥上传下载等,

后续 Demo 开发中会涉及到这些内容。

当创建完应用之后,点击页面最下方的“返回应用列表”

可以返回到应用列表,或者访问 http://console.qcloud.com/avc 进入应用列表,可以对应用进

行配置

下面的截图给出了独立和托管两种集成模式下的应用配置情况,

Page 6: 1、整体准备工作 · 3、即时通信Demo快速入门 即通通信Demo 包含了一个类似手机QQ 的IM 功能,包括以下功能: 帐号(手机号码,字符串帐号)注册,登录,设置帐号昵称

【说明】独立模式下,在测试和调试阶段用户可以使用下载公私钥的形式,下载公私钥之后

公钥会自动同步到腾讯的验证服务器。

【推荐】如果开发者本地生成了公私钥,可以点击右边的“编辑”按钮,选择自有“自有生

成公私钥”tab,然后把公钥上传给腾讯的服务器。

Page 7: 1、整体准备工作 · 3、即时通信Demo快速入门 即通通信Demo 包含了一个类似手机QQ 的IM 功能,包括以下功能: 帐号(手机号码,字符串帐号)注册,登录,设置帐号昵称

【说明】托管模式下,私钥由腾讯服务器保留,因为应用的帐号信息都托管在腾讯的服务器。

3、即时通信 Demo 快速入门

即通通信 Demo 包含了一个类似手机 QQ 的 IM 功能,包括以下功能:

帐号(手机号码,字符串帐号)注册,登录,设置帐号昵称

C2C 关系链维护:添加删除拉黑

群关系链维护:分公开群、讨论组和聊天室三种类型。可以创建,加群,退群

群资料维护:群名称、简介,公告修改

群成员管理:角色修改、禁言

C2C 沟通功能:收发文字,图片,表情,文件,语音,双人音视频

群沟通功能:收发文字,图片,表情,文件,语音

聊天消息删除功能

请点击即时通信 SDK 下载体验。

Page 8: 1、整体准备工作 · 3、即时通信Demo快速入门 即通通信Demo 包含了一个类似手机QQ 的IM 功能,包括以下功能: 帐号(手机号码,字符串帐号)注册,登录,设置帐号昵称

3.1 ios demo 使用说明

3.1.1 SDK 的参数配置

开发者可以不用修改任何参数直接体验 demo的功能。在申请接入腾讯音视频云通信后,

1、 如果选择的是托管模式集成自有帐号,可以在 GlobalData.h 中配置 ios 客户端 SDK 全局

参数:kSdkAccountType(即 accountType)、kSdkAppId(即 SdkAppid)、kAppidAt3rd

(同 SdkAppid),开发者将这几个参数替换成自己申请的,此时 demo就类似于开发者自

己的 app了,demo里的各种功能也是可以正常使用的;

2、 如果选择的是独立模式集成自有帐号,开发者需要到自己的帐号服务器进行用户密码验

证,验证成功后需要服务器派发一个签名(UserSig),然后在 GlobalData.h 中配置 ios

客户端 SDK 全局参数:kSdkAccountType(即 accountType)、kSdkAppId(即 SdkAppid)、

kAppidAt3rd(同 SdkAppid),开发者将这几个参数替换成自己申请的,接着就可以使用

即时通信服务了。独立模式集成流程详见帐号登录集成说明。

在 AppDelegate.m 中,配置 TLS SDK 参数,其中 hostIp 和 hostPort 分别设置为 nil 和 0表示连

接 TLS SDK 的正式环境,localId 设置语言为简体中文,countryId 设置地区为中国大陆。

在 UserConfig.m 中,配置音视频 SDK参数,isTestServer 和 sdkAppIdToken 使用默认配置。

Page 9: 1、整体准备工作 · 3、即时通信Demo快速入门 即通通信Demo 包含了一个类似手机QQ 的IM 功能,包括以下功能: 帐号(手机号码,字符串帐号)注册,登录,设置帐号昵称

3.1.2 demo 使用简介

1、点击“手机账户登录/注册新用户”,用手机号码获取短信验证码注册;返回用手机号登

2、用户名账户登录/注册新用户

Page 10: 1、整体准备工作 · 3、即时通信Demo快速入门 即通通信Demo 包含了一个类似手机QQ 的IM 功能,包括以下功能: 帐号(手机号码,字符串帐号)注册,登录,设置帐号昵称

3、添加好友、群维护入口

4、建群或添加群

Page 11: 1、整体准备工作 · 3、即时通信Demo快速入门 即通通信Demo 包含了一个类似手机QQ 的IM 功能,包括以下功能: 帐号(手机号码,字符串帐号)注册,登录,设置帐号昵称

5、点击好友或群进行消息收发操作

6、查找好友

Page 12: 1、整体准备工作 · 3、即时通信Demo快速入门 即通通信Demo 包含了一个类似手机QQ 的IM 功能,包括以下功能: 帐号(手机号码,字符串帐号)注册,登录,设置帐号昵称

7、好友申请

Page 13: 1、整体准备工作 · 3、即时通信Demo快速入门 即通通信Demo 包含了一个类似手机QQ 的IM 功能,包括以下功能: 帐号(手机号码,字符串帐号)注册,登录,设置帐号昵称

8、删除消息

Page 14: 1、整体准备工作 · 3、即时通信Demo快速入门 即通通信Demo 包含了一个类似手机QQ 的IM 功能,包括以下功能: 帐号(手机号码,字符串帐号)注册,登录,设置帐号昵称

3.2 android demo 使用说明

3.2.1 SDK 的参数配置

开发者可以不用修改任何参数直接体验 demo的功能。在申请接入腾讯音视频云通信后,

1、 如果选择的是托管模式集成自有帐号,可以在 com.example.mydemo.utils.Constant 中配

置 android 客户端 SDK 全局参数:ACCOUNT_TYPE(即 accountType)、SDK_APPID(即

sdkAppid),将这两个参数替换成自己申请的,此时 demo就类似于开发者自己的 app了,

demo里的各种功能也是可以正常使用的;

2、 如果选择的是独立模式集成自有帐号,开发者需要到自己的帐号服务器进行用户密码验

证 , 验 证 成 功 后 需 要 服 务 器 派 发 一 个 签 名 ( UserSig ) , 然 后 在

com.example.mydemo.utils.Constant中配置 android客户端 SDK全局参数:ACCOUNT_TYPE

(即 accountType)、SDK_APPID(即 sdkAppid),将这两个参数替换成自己申请的,接

着就可以使用即时通信服务了。独立模式集成流程详见帐号登录集成说明。

Page 15: 1、整体准备工作 · 3、即时通信Demo快速入门 即通通信Demo 包含了一个类似手机QQ 的IM 功能,包括以下功能: 帐号(手机号码,字符串帐号)注册,登录,设置帐号昵称

3.2.2 demo 使用简介

1、点击“手机账户登录/注册新用户”,用手机号码获取验证码注册;返回用手机号登录

2、用户名账户登录/注册新用户

Page 16: 1、整体准备工作 · 3、即时通信Demo快速入门 即通通信Demo 包含了一个类似手机QQ 的IM 功能,包括以下功能: 帐号(手机号码,字符串帐号)注册,登录,设置帐号昵称

3、添加好友、群维护入口

4、建群或添加群

Page 17: 1、整体准备工作 · 3、即时通信Demo快速入门 即通通信Demo 包含了一个类似手机QQ 的IM 功能,包括以下功能: 帐号(手机号码,字符串帐号)注册,登录,设置帐号昵称

5、查找好友

6、通过好友请求

Page 18: 1、整体准备工作 · 3、即时通信Demo快速入门 即通通信Demo 包含了一个类似手机QQ 的IM 功能,包括以下功能: 帐号(手机号码,字符串帐号)注册,登录,设置帐号昵称

7、点击好友或群进行消息收发操作。长按消息可以删除等操作

Page 19: 1、整体准备工作 · 3、即时通信Demo快速入门 即通通信Demo 包含了一个类似手机QQ 的IM 功能,包括以下功能: 帐号(手机号码,字符串帐号)注册,登录,设置帐号昵称

4、音视频 Demo 快速入门

音视频 Demo 包含了一个类似手机 QQ 的视频功能,包括以下功能:

帐号(手机号码,字符串帐号)注册,登录;

创建房间

双人通话

多人通话

通话过程中摄像头控制,麦克风控制;

请点击音视频 SDK 下载体验。

4.1 ios demo 使用说明

4.1.1 SDK 的参数配置

开发者可以不用修改任何参数直接体验 demo 的功能。在申请接入腾讯音视频云通信后,

1、 如果选择的是托管模式集成自有帐号,可以在 AVTLSDemo-Prefix.pch 中配置 iOS 客户端

SDK 全局参数:kAVSDKDemo_AccountType(即 accountType)、kAVSDKDemo_SdkAppId(即

sdkAppid),将这两个参数替换成自己申请的,此时 demo 就类似于开发者自己的 app 了,

demo 里的各种功能也是可以正常使用的;

2、 如果选择的是独立模式集成自有帐号,开发者需要到自己的帐号服务器进行用户密码验

证,验证成功后需要服务器派发一个签名(UserSig),然后在 AVTLSDemo-Prefix.pch 中配置

iOS 客 户 端 SDK 全 局 参 数 : kAVSDKDemo_AccountType ( 即 accountType ) 、

kAVSDKDemo_SdkAppId(即 sdkAppid),将这两个参数替换成自己申请的,接着就可以使用

音视频服务了。独立模式集成流程详见帐号登录集成说明。

4.1.2 demo 使用简介

1、 注册和登录

Page 20: 1、整体准备工作 · 3、即时通信Demo快速入门 即通通信Demo 包含了一个类似手机QQ 的IM 功能,包括以下功能: 帐号(手机号码,字符串帐号)注册,登录,设置帐号昵称

2、登录成功后(如下左图),用户可击房间号进行修改房间号,然后“进入”进入多人通

话(如下右图)

3、进入多人通话,开启摄像头(如图一),标示自己可以与其他人视频。当有其他人进入

房间并开启摄像头时(如图二),可以点击其头像进行视频通话(如图三)

Page 21: 1、整体准备工作 · 3、即时通信Demo快速入门 即通通信Demo 包含了一个类似手机QQ 的IM 功能,包括以下功能: 帐号(手机号码,字符串帐号)注册,登录,设置帐号昵称

在多人通话界面可以通过点击静音来打开和关闭麦克风,右滑查看进入房间的成员(如下左

图),左滑出现通话设置(如下右图)

Page 22: 1、整体准备工作 · 3、即时通信Demo快速入门 即通通信Demo 包含了一个类似手机QQ 的IM 功能,包括以下功能: 帐号(手机号码,字符串帐号)注册,登录,设置帐号昵称

4、双人通话

为方便体验双人音视频通话功能,可用两个用机,同时切换到双人通话,发起方在选择帐号

界面填写接收方手机号,点击确定进行呼叫

Page 23: 1、整体准备工作 · 3、即时通信Demo快速入门 即通通信Demo 包含了一个类似手机QQ 的IM 功能,包括以下功能: 帐号(手机号码,字符串帐号)注册,登录,设置帐号昵称

接收方点击 Accept 接收会话邀请,双方可通过设置像头以及麦克风(同多人通话)来进行

视频通话

Page 24: 1、整体准备工作 · 3、即时通信Demo快速入门 即通通信Demo 包含了一个类似手机QQ 的IM 功能,包括以下功能: 帐号(手机号码,字符串帐号)注册,登录,设置帐号昵称

4.2 android demo 使用说明

开发者可以不用修改任何参数直接体验 demo 的功能。在申请接入腾讯音视频云通信后,

1、 如果选择的是托管模式集成自有帐号,可以在应用中修改 ACCOUNT_TYPE(即

accountType)、SDK_APPID(即 sdkAppid),将这两个参数替换成自己申请的,此时 demo 就

类似于开发者自己的 app 了,demo 里的各种功能也是可以正常使用的;

2、 如果选择的是独立模式集成自有帐号,开发者需要到自己的帐号服务器进行用户密码验

证,验证成功后需要服务器派发一个签名(UserSig),然后在应用中修改 ACCOUNT_TYPE(即

accountType)、SDK_APPID(即 sdkAppid),将这两个参数替换成自己申请的,接着就可以

使用音视频服务了。独立模式集成流程详见帐号登录集成说明。

4.2.1 双人音视频 demo

1、注册和登录

2、修改 appid 和 uid

Page 25: 1、整体准备工作 · 3、即时通信Demo快速入门 即通通信Demo 包含了一个类似手机QQ 的IM 功能,包括以下功能: 帐号(手机号码,字符串帐号)注册,登录,设置帐号昵称

3、创建房间

1)发起方:点击“接收方”后选择接收方的测试号;

2)发起方:点击 或 邀请接收方进行音频或视频通话,弹出等待框;

Page 26: 1、整体准备工作 · 3、即时通信Demo快速入门 即通通信Demo 包含了一个类似手机QQ 的IM 功能,包括以下功能: 帐号(手机号码,字符串帐号)注册,登录,设置帐号昵称

3) 接收方:收到邀请通知后点击确定

4、进行视频通话

Page 27: 1、整体准备工作 · 3、即时通信Demo快速入门 即通通信Demo 包含了一个类似手机QQ 的IM 功能,包括以下功能: 帐号(手机号码,字符串帐号)注册,登录,设置帐号昵称

1) 进入音频通话房间后,有免提开关按钮和麦克风开关按钮控制相关功能,点击 结

束通话;

2) 进入视频通话房间后,默认是进行语音通话。如果要进行视频通话,可以点击摄像头开

关控制显示自己的摄像头;打开摄像头后会有切换摄像头按钮控制切换前后摄像头;其它操

作与音频通话房间相同。

Page 28: 1、整体准备工作 · 3、即时通信Demo快速入门 即通通信Demo 包含了一个类似手机QQ 的IM 功能,包括以下功能: 帐号(手机号码,字符串帐号)注册,登录,设置帐号昵称

4.2.2 多人音视频 demo

1、注册和登录

Page 29: 1、整体准备工作 · 3、即时通信Demo快速入门 即通通信Demo 包含了一个类似手机QQ 的IM 功能,包括以下功能: 帐号(手机号码,字符串帐号)注册,登录,设置帐号昵称

2、修改 appid 和 uid

3、创建房间

点击“编辑讨论组号”后的编辑框设置讨论组号,后点创建房间,就创建/进入房间了。

注:如果有几个帐号要通话,那么它们的讨论组号设置成一样即可。讨论组号不同,则不同

的帐号就不会进入同一个房间,也就不能通话。

Page 30: 1、整体准备工作 · 3、即时通信Demo快速入门 即通通信Demo 包含了一个类似手机QQ 的IM 功能,包括以下功能: 帐号(手机号码,字符串帐号)注册,登录,设置帐号昵称

4、进行视频通话

进入房间后,默认是进行语音通话。如果要进行视频通话,可以打开自己的摄像头,对方请

求自己的画面就可以看到自己的画面;如果对方有视频,也可以点击“对方”的头像以请求

对方的画面。