什么是建融云服务器,融云开发者文档

# 功能描述

在应用的整个生命周期,此方法只需要调用一次。之后无论是网络异常还是 App 有前后台的切换,SDK 都会自动重连。除非连接失败或者开发者调用 断开连接 的接口,否则不需要再做重连。

# 调用连接接口

# 接口示例 1

输入参数: 参数 类型 必填 说明 token NSString 是 需要您的 Server 访问融云服务获取 Token

dbOpenedBlock Block - 本地消息数据库打开的回调

successBlock Block - 连接建立成功的回调

errorBlock Block - 连接建立失败的回调

回调参数:

dbOpenedBlock 说明: 回调参数 回调类型 说明 code RCDBErrorCode 数据库是否已打开

successBlock 说明: 回调参数 回调类型 说明 userId NSString 当前连接成功的用户 ID

errorBlock 说明:

代码示例:

# 接口示例 2

输入参数: 参数 类型 必填 说明 token NSString 是 需要您的 Server 调用 融云服务获取 Token

timeLimit int 是 SDK 连接超时时间,单位:秒

dbOpenedBlock Block - 本地消息数据库打开的回调

successBlock Block - 连接建立成功的回调

errorBlock Block - 连接建立失败的回调

timeLimit 说明: 参数 取值范围 说明 timeLimit <=0 SDK 会一直连接,直到连接成功或者出现 SDK 无法处理的错误(如 token 非法),等效于上面的连接接口。

timeLimit >0 SDK 最多连接 timeLimit 秒,超时则返回 RC_CONNECT_TIMEOUT 错误,并不再重连。

回调参数:

dbOpenedBlock 说明: 回调参数 回调类型 说明 code RCDBErrorCode 数据库是否已打开

successBlock 说明: 回调参数 回调类型 说明 userId NSString 当前连接成功的用户 ID

errorBlock 说明:

代码示例:

# 回调说明

当回调 errorBlock 时 SDK 不会再进行重连,具体的错误信息请参见文末。

RC_CONN_TOKEN_INCORRECT 的说明: 可能原因 排查方案 token 错误 检查客户端初始化使用的 AppKey 和您服务器获取 Token 使用的 AppKey 是否一致。

token 过期 检查是否在 开发者后台(opens new window) 设置了 Token 过期时间。过期之后需要请求您的服务器重新获取 Token 并再次用新的 Token 建立连接

在 RC_CONN_TOKEN_INCORRECT 的情况下,您需要请求您的服务器重新获取 Token 并建立连接,但是注意避免无限循环,以免影响 App 用户体验。

此方法的回调线程并非为原调用线程,需要进行 UI 操作时请注意切换到主线程。

# 接口调用建议

用户初次登录:

APP 在用户点击登录时连接融云,建议使用带 timeLimit 的接口。这样在初次登录时如果遇到网络问题,SDK 可以及时回调连接超时,由 APP 对用户进行提醒,请用户在网络正常的时候再重新登录。

用户免密登录:

用户登录过一次之后,很多 APP 都会提供免密登录的功能。用户免密登录时,可以使用不带 timeLimit 的接口。这样即使网络异常,SDK 也会自动重连,并在重连成功之后返回成功回调。

# 设置连接监听

代码示例

# 连接错误码 错误码 说明 处理方案 31004 Token 无效 从 APP 服务器获取新的 token ,再调用 connect 接口进行连接

31010 用户连接成功后被踢下线 退回到登录页面,给用户提示被踢掉线

31023 用户连接过程中又在其它设备上登录,导致当前设备被踢 退回到登录页面,给用户提示其他设备登录了当前账号

31011 用户被封禁 退回到登录页面,给用户提示被封禁

34006 自动重连超时(发生在 timeLimit 为有效值并且网络极差的情况下) 重新调用 connect 接口进行连接

31008 Appkey 被封禁 请检查您使用的 AppKey 是否被封禁或已删除

33001 SDK 没有初始化 在使用 SDK 任何功能之前,必须先 Init

33003 开发者接口调用时传入的参数错误 请检查接口调用时传入的参数类型和值

33002 数据库错误 检查用户 userId 是否包含特殊字符,SDK userId 支持大小写英文字母、数字、部分特殊符号 + = - _ 的组合方式,最大长度 64 字节

### 回答1: 为了实现实时通讯功能,可以在uniapp项目中接入云。首先在云官网注册账号,并创建应用获取appKey和appSecret。随后可以使用uniapp插件市场里的云插件,或者手动导入云SDK。 在uniapp项目中引入云插件或SDK后,可以调用相应的API实现聊天功能。常用的API包括连接服务器、发送消息、接收消息、获取会话列表等。需要注意的是,云提供了多种类型的消息,包括文字、图片、语音、文件等,需要根据具体需求选择合适的类型。 为了方便开发和维护,可以对云API进行封装。比如封装发送消息的方法,可以提供一个参数对象,包含消息类型、接收者、发送者、内容等信息,内部调用云API发送消息。这样可以在应用中简化代码,提高开发效率和程序可维护性。 总之,接入云是实现实时通讯的有效方法,通过调用云提供的API实现聊天功能。需要注意选择合适的消息类型,并封装API以方便开发和维护。 ### 回答2: 在UniApp中接入云,需要进行如下步骤: 1.注册云账号并创建应用。可以在云官网进行注册并创建应用,获取AppKey和AppSecret。 2.下载并安装云SDK。在云官网下载SDK并按照官方文档进行安装。 3.在UniApp项目中安装uni-app-plugin-im插件。该插件已经完成了对云SDK的封装,可以便于开发者进行快速开发。安装方法:在终端中运行npm install @dcloudio/uni-app-plugin-im --save命令。 4.在manifest.json文件中添加插件配置。在"uni-app-plugin-im"节点中添加"appKey"和"appSecret"节点并填入相应的信息。 5.在需要使用云的页面中使用插件提供的API进行开发。例如,可以使用im.createDiscussion()创建讨论组,使用im.sendMessage()发送消息等等。 总之,通过将云SDK与uni-app-plugin-im插件进行结合,可以使得在UniApp中接入云变得十分简单快捷,方便开发者快速开发出有IM功能的app。 ### 回答3: Uniapp是基于Vue.js框架的移动端开发框架。云是一款强大的即时通讯云服务,支持文字、语音、图片、视频等多种形式的消息传递。将Uniapp与云结合起来,可以实现高效、流畅的即时通讯功能。 首先,我们需要在Uniapp项目中引入云SDK,并进行初始化。可以在main.js文件中进行如下配置: ```js import RongIM from 'vue-rong-im'; Vue.use(RongIM, { appKey: 'your appKey', }); ``` 其中,appKey是云提供的用于标识应用程序的唯一标识符,可以在云开发者平台上获取。 接下来,我们可以在需要使用即时通讯功能的组件中,引入云的组件并使用其提供的接口进行消息的发送和接收。 ```js <template> <div> <!-- 聊天窗口 --> <rong-im :conversationType="conversationType" :targetId="targetId"></rong-im> <!-- 输入框和发送按钮 --> <div> <input type="text" v-model="message"> <button @click="send">发送</button> </div> </div> </template> <script> import { RongIMClient } from 'rong-im-lib'; export default { data() { return { message: '', conversationType: RongIMClient.ConversationType.PRIVATE, targetId: 'target id', }; }, methods: { send() { // 调用云SDK的sendMessage方法发送消息 RongIMClient.getInstance().sendMessage( this.conversationType, this.targetId, { content: this.message }, { onSuccess() { console.log('发送成功'); }, onError(error) { console.log('发送失败:', error); }, }, ); }, }, }; </script> ``` 在上述代码中,我们使用了云提供的vue-rong-im组件作为聊天窗口,同时调用了云SDK的sendMessage方法发送消息。在发送成功或失败时,可以通过回调函数进行相应的处理。 综上所述,通过在Uniapp中接入云,我们可以快速实现高效、流畅的即时通讯功能。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值