接入说明
本文旨在让第三方开发者快速将BBBUG聊天室快速接入到自己的网站中,以为自己网站快速提供群聊/音乐/游戏等聊天室功能。
接入方案
我们使用iframe进行BBBUG聊天室地址的嵌入即可完成快速的集成,数据通信与交互采用HTML5的postMessage
进行松耦合的方式完成。
用户集成方案
第一步,将自己网站上的用户登录到BBBUG上,如用户未注册,则按OpenID自动注册。
具体请求方式查看Tester上的用例:
https://tester.hamm.cn/#/20200907/8ee5587f6190e1a56cec5d18276cbef0e4b06602
字段 | 类型 | 必填 | 示例 |
---|---|---|---|
appid | string | 是 | 你的appid |
appkey | string | 是 | 你的appkey |
openid | string | 是 | 用户在你网站的唯一账号 标识 |
head | string | 是 | 用户的头像URL |
nickname | string | 是 | 用户的昵称 |
extra | string | 是 | 回源URL中#extra# 将替换为此字段 |
第二步,嵌入iframe到你的网站上,嵌入的URL为:
https://bbbug.com/?access_token=ACCESS_TOKEN&room_id=ROOM_ID
其中,ACCESS_TOKEN
为第一步获取到的身份凭证,如不提供,则以临时用户进入。ROOM_ID
为你想要进入的房间ID,请注意,房间必须为公开房间,如不传,则进入默认888房间。
临时用户说明
如不需要接入自己的用户体系,直接集成上面第二步的URL,不传入access_token
即可。
进入自己创建的房间
为了提供更为个性化的服务,我们支持你接入自己创建的房间,进行更好的用户管理,如需要,请集成第二步的URL时,传入指定的room_id
即可。
合作案例
更多功能
更多个性化服务正在开发设计中。
联系我
你可以通过QQ:455250574
或者Email:admin#hamm.cn
(#换成@)联系我们进行合作 :)