闲聊sdk接入说明

Comment A1 由于闲聊功能的开发 周期较长 而闲聊所给的文档为最早 期文档 期间闲聊方对 sdk 有更新而 文档未做更新 所以这些文档建议当 作参考 闲聊闲聊 SDK 接入接入 以下是游戏需求 Ctrl 点击进入超链接 游戏场景图 需求补充 游戏头像以及昵称按照最先点击登录的类型处理 即先点击哪种登录方式 就 以该种登录方式显示 以下是闲聊给出的文档 闲聊安卓开发文档 闲聊 IOS 开发文档 闲聊 server 开发文档 以下是闲聊给出的 demo 在开发过程中闲聊有更换 sdk 所以他们的 demo 仅做参考 安卓 demo IOS demo 以下是河南麻将项目接入文档 并未完全按照闲聊所给文档接入 一 安卓篇一 安卓篇 1 在 Eclipse 内导入 sugramsdk jar 2 在 android 项目内添加 SGEntryActivity java 位置为 henmj android src com happyplay h nmj sgapi 3 在 android 项目内添加 MyHttpClient java SSLSocketFactoryEx java XianLiaoActivity java 三 个文件 位置为 henmj android src org cocos2dx javascript Comment A2 闲聊初始化 Comment A3 获取 XianLiaoActivity 传递过来的 intent 4 在 android 项目内修改 AppActivity java 1 添加以下内容 xianliao import org sugram im sdk api ISGAPI import org sugram im sdk api SGAPIFactory import org sugram im sdk constants SGConstants import org sugram im sdk modelmsg SGGameObject import org sugram im sdk modelmsg SGImageObject import org sugram im sdk modelmsg SGMediaMessage import org sugram im sdk modelmsg SGTextObject import org sugram im sdk modelmsg SendMessageToSG 2 在 AppActivity 里添加 public class AppActivity extends Cocos2dxActivity xianliao public ISGAPI sgApi public static String XL AppID xxxxxxxxxx 闲聊审核获得 xxxxxxxxxx public static String XL AppSecret xxxxxxxx 闲聊审核获得 xxxxxxxxxx public String xlInviteGameInfo 3 在 onCreate 函数内添加 public void onCreate Bundle savedInstanceState xianLiaoInit get intent data from XianLiaoActivity Bundle bundle getIntent getExtras if bundle null String msg bundle getString XL InviteGameInfo xlInviteGameInfo msg Log i getIntent getIntent XL InviteGameInfo msg try this writeFileData xianliao txt has xianliao catch IOException e Comment A4 传递 类型和 类型时 结构不同 Comment A5 防止代码冲突 Comment A6 防止代码冲突 4 添加函数 RunJS obj param 是 对象的 public void RunJS obj String name String param Cocos2dxHelper runOnGLThread new Runnable String js String para Override public void run TODO Auto generated method stub String command cc eventManager dispatchCustomEvent js para org cocos2dx lib Cocos2dxJavascriptJavaBridge evalString command public Runnable setjs String js String pa this js js this para pa return this setjs name param 5 添加函数 xianLiaoInit public void xianLiaoInit 通过 SGAPIFactory 工厂 获取 ISGAPI 实 sgApi SGAPIFactory createSGAPI this XL AppID sgApi registerApp XL AppID 6 修改微信登录函数 wxLogin 把 SendAuth Req req new SendAuth Req 改为 com tencent mm sdk modelm sg SendAuth Req req new com tencent mm sdk modelmsg SendAuth Req 7 添加函数 xianLiaoLogin public void xianLiaoLogin if isXLInstall org sugram im sdk modelmsg SendAuth Req req new org sugram im sdk modelmsg SendAuth Req req state none sgApi sendReq req 8 添加函数 isXLInstall 判断闲聊是否安装 Comment A7 闲聊分享文本 Comment A8 闲聊邀请游戏 public boolean isXLInstall boolean haveXL sgApi isSGAppInstalled if haveXL return true else doWithoutXLApp return false 9 添加函数 doWithoutXLApp have no xl app public void doWithoutXLApp Log i xianliao doWithoutXLApp Intent viewIntent new Intent android intent action VIEW Uri parse startActivity viewIntent 10 添加函数 xlShareText public void xlShareText String text if isXLInstall 初始化一个 SGTextObject 对象 填写分享的文本内容 SGTextObject textObject new SGTextObject textObject text text 用 SGTextObject 对象初始化一个 SGMediaMessage 对象 SGMediaMessage msg new SGMediaMessage msg mediaObject textObject 构造一个 Req SendMessageToSG Req req new SendMessageToSG Req req transaction SGConstants T TEXT 分享文本 req mediaMessage msg req scene SendMessageToSG Req SGSceneSession 代表分享到会话 表 调用 api 接口发送数据到闲聊 sgApi sendReq req 11 添加函数 xlShareInviteGame public void xlShareInviteGame String roomId String roomToken String title String description if isXLInstall Bitmap bitmap BitmapFactory decodeResource getResources R drawable icon Comment A9 闲聊分享图片 初始化一个 SGGameObject 对象 设置所分享的游戏图片内容 SGGameObject gameObject new SGGameObject bitmap gameObject roomId roomId gameObject roomToken roomToken 用 SGGameObject 对象初始化一个 SGMediaMessage 对象 SGMediaMessage msg new SGMediaMessage msg mediaObject gameObject msg title title msg description description 构造一个 Req SendMessageToSG Req req new SendMessageToSG Req req transaction SGConstants T GAME req mediaMessage msg req scene SendMessageToSG Req SGSceneSession 代表分享到会话 表 调用 api 接口发送数据到闲聊 sgApi sendReq req 12 添加函数 xlShareTexture public void xlShareTexture String path if isXLInstall Bitmap bitmap BitmapFactory decodeFile path 初始化一个 SGImageObject 对象 设置所分享的图片内容 SGImageObject imageObject new SGImageObject Bitmap createScaledBitmap bitmap 1000 int bitmap getHeight bitmap getWidth 1000f true 用 SGImageObject 对象初始化一个 SGMediaMessage 对象 SGMediaMessage msg new SGMediaMessage msg mediaObject imageObject 构造一个 Req SendMessageToSG Req req new SendMessageToSG Req req transaction SGConstants T IMAGE req mediaMessage msg req scene SendMessageToSG Req SGSceneSession 代表分享到会话 列表 调用 api 接口发送数据到 Sugram sgApi sendReq req Comment A10 获取闲聊发送过来的 邀请信息 Comment A11 Js 调用闲聊登录 Comment A12 Js 调用闲聊分享文本 Comment A13 Js 调用闲聊分享游戏 邀请 Comment A14 Js 调用闲聊分享图片 Comment A15 Js 调用获取闲聊的邀 请信息 13 添加函数 GetXLInviteGameInfo public void GetXLInviteGameInfo String rtn msg xlInviteGameInfo if rtn msg RunJS obj XL InviteGameInfo rtn msg xlInviteGameInfo 14 添加函数 StartXianLiaoLogin public static void StartXianLiaoLogin if ccActivity null ccActivity xianLiaoLogin 15 添加函数 StartShareTextToXL public static void StartShareTextToXL String path if ccActivity null ccActivity xlShareText path 16 添加函数 StartShareInviteGameToXL public static void StartShareInviteGameToXL String roomId String roomToken String title String description if ccActivity null ccActivity xlShareInviteGame roomId roomToken title description 17 添加函数 StartShareTextureToXL public static void StartShareTextureToXL String path if ccActivity null ccActivity xlShareTexture path 18 添加函数 xlGetInviteGameInfo public static void xlGetInviteGameInfo if ccActivity null ccActivity GetXLInviteGameInfo 19 在 AndroidManifest xml 中添加 二 二 JS 篇篇 1 在 app js 中修改函数 jsclient logout 在函数中添加以下内容 jsclient logout function if jsclient remoteCfg httpLogin sys localStorage removeItem WX USER LOGIN sys localStorage removeItem XL USER LOGIN sys localStorage removeItem LoginType sys localStorage removeItem loginData sendEvent logout else jsclient block jsclient gamenet request pkcon handler logout function sys localStorage removeItem WX USER LOGIN sys localStorage removeItem XL USER LOGIN sys localStorage removeItem LoginType sys localStorage removeItem loginData sendEvent logout jsclient unblock 2 在 app js 中添加函数 getWXunionid jsclient getWXunionid function var unionid var WX USER LOGIN sys localStorage getItem WX USER LOGIN if WX USER LOGIN WX USER LOGIN JSON parse WX USER LOGIN unionid WX USER LOGIN unionid Comment A19 查询 存储第一次登 陆的登录方式 微信 闲聊 Comment A20 收到游戏邀请信息后 的操作 return unionid 3 在 app js 中添加函数 operateFirstLoginType jsclient operateFirstLoginType function type if type var loginType sys localStorage getItem LoginType if loginType return loginType else if type sys localStorage setItem LoginType type return type else return null 4 在 app js 中添加函数 doInviteGameInfo jsclient doInviteGameInfo function para if para return 玩家还未登陆 if jsclient loginui jsclient showMsgDelay 0 2 请先登陆游戏后再次点击游戏约局信息 玩家已经登录 未在房间内 else if jsclient data sData jsclient joinGame para roomId para roomToken gameType 玩家已经登录 在房间内 else if jsclient data sData var sData jsclient data sData var tData sData tData var xl type para roomToken gameType var xl roomid para roomId var pp type sData gameid var pp roomid tData tableid if xl type pp type xl roomid pp roomid Comment A21 检查是否进行了闲聊 授权并进行分享 Comment A22 延时显示 showMsg 界面 因为当游戏在后台时 调用界 面会缺失纹理 暂时没有找到别的解 决办法 只能用这种办法处理 哪位 同志学如果有好的方法请指教指教 多谢 jsclient showMsgDelay 0 2 您现在已经在游戏中 请先退出当前房间后 再次点击游戏约局信息 5 在 app js 中添加函数 xlCheckAndShare jsclient xlCheckAndShare function 检查是否进行过闲聊授权 此处为第二处可以关联微信 闲聊 皮皮账号的地 方 如果没有就进行闲聊授权登录 var XL USER LOGIN sys localStorage getItem XL USER LOGIN if XL USER LOGIN if jsclient native jsclient native xlLogin return 进行函数调用 if jsclient xianLiaoPara var para jsclient xianLiaoPara if para type XianLiaoType text 文本 var text para text jsclient native xlShareText text else if para type XianLiaoType image 图片 jsclient native xlShareImage else 游戏邀请 var roomId para roomId var roomToken para roomToken var title para title var description para description jsclient native xlInviteGame roomId roomToken title description 6 在 app js 中添加函数 showMsgDelay jsclient showMsgDelay function delay msg yesfunc nofunc style if jsclient Scene jsclient Scene scheduleOnce function jsclient showMsg msg yesfunc nofunc style delay 7 在 app js 中的 CallBack 中的 initSceneData 消息中添加 xlGetInviteGameInfo 的函 Comment A23 使用闲聊拉起游戏后 需要检测三次游戏邀请信息 此处为 创建房间后的检测 Comment A24 这里检测邀请信息 Comment A25 使用闲聊拉起游戏后 需要检测三次游戏邀请信息 此处为 登录成功后的检测 Comment A26 收到邀请信息的处理 Comment A27 闲聊登录 Comment A28 闲聊游戏邀请 数调用 initSceneData 0 function d if d tData roundNum 0 else jsclient native xlGetInviteGameInfo 9 在 app js 中的 JSScene 的 jsBind 中添加 XL InviteGameInfo 消息 XL InviteGameInfo function para jsclient doInviteGameInfo para 10 在 app js 中的 jsclient native 中添加 xlLogin 函数 xlLogin function try if cc sys OS ANDROID cc sys os jsb reflection callStaticMethod org cocos2dx javascript AppActivity Start XianLiaoLogin V else if cc sys OS IOS cc sys os jsb reflection callStaticMethod AppController sendXLRequest catch e jsclient native HelloOC xianLiaoLogin throw JSON stringify e 11 在 app js 中的 jsclient native 中添加 xlInviteGame 函数 xlInviteGame function roomId roomToken title description try if cc sys OS ANDROID cc sys os Comment A29 闲聊图片分享 jsb reflection callStaticMethod org cocos2dx javascript AppActivity StartShareInviteGameToXL Ljava lang String Ljava lang String Ljava lang String Ljava lang String V roomId roomToken title description else if cc sys OS IOS cc sys os jsb reflection callStaticMethod AppController xlShareInvite AndID AndTitle AndText roomToken roomId title description catch e jsclient native HelloOC XLInviteGame throw JSON stringify e 12 在 app js 中的 jsclient native 中添加 xlShareImage 函数 xlShareImage function try var writePath jsb fileUtils getWritablePath var textrueName wxcapture screen png if cc sys OS ANDROID cc sys os jsb reflection callStaticMethod org cocos2dx javascript AppActivity StartShareTextureToXL Ljava lang String V writePath textrueName else if cc sys OS IOS cc sys os var writePath jsb fileUtils getWritablePath var textrueName wxcapture screen png jsb reflection callStaticMethod AppController xlShareImage writePath textrueName Comment A30 闲聊文本分享 Comment A31 闲聊查询游戏邀请信 息 Comment A32 这里请自己加上自己 项目的控制信息 防止调用出错 Comment A33 检测时候为使用闲聊 登录并附加闲聊信息到登录信息 catch e jsclient native HelloOC XLShareImage throw JSON stringify e 13 在 app js 中的 jsclient native 中添加 xlShareText 函数 xlShareText function text try if cc sys OS ANDROID cc sys os jsb reflection callStaticMethod org cocos2dx javascript AppActivity StartShareTextToXL Ljava lang String V text else if cc sys OS IOS cc sys os jsb reflection callStaticMethod AppController xlShareText AndText 四方河南麻将 text catch e jsclient native HelloOC xlShareText throw JSON stringify e 14 在 app js 中的 jsclient native 中添加 xlGetInviteGameInfo 函数 xlGetInviteGameInfo function try if cc sys OS ANDROID cc sys os jsb reflection callStaticMethod org cocos2dx javascript AppActivity xlGetI nviteGameInfo V else if cc sys OS IOS cc sys os jsb reflection callStaticMethod AppController xlGetInviteGameInfo catch e jsclient native HelloOC xlGetInviteGameInfo throw JSON stringify e 15 在 Login js 中添加变量 xlLoginPara 16 在 Login js 中的 f login 函数中添加 Comment A34 获取首次登陆类型 Comment A35 判断是否在自动登录 if xlLoginPara useSugram loginData useSugram xlLoginPara useSugram loginData xl unionid xlLoginPara xl unionid loginData xl nickname xlLoginPara xl nickname loginData xl headimgurl xlLoginPara xl headimgurl 17 在 Login js 中修改函数 autoLogin jsclient autoLogin function jsclient block var type jsclient operateFirstLoginType var beginLogin false mylog 判断是否可以进行闲聊或者微信的自动登录 type type if type wx mylog 开始进行微信自动登录 var WX USER LOGIN sys localStorage getItem WX USER LOGIN if WX USER LOGIN mylog 微信自动登录 WX USER LOGIN JSON parse WX USER LOGIN LoginAsWeChat WX USER LOGIN beginLogin true else if type xl mylog 开始进行闲聊自动登录 var XL USER LOGIN sys localStorage getItem XL USER LOGIN if XL USER LOGIN mylog 闲聊自动登录 XL USER LOGIN JSON parse XL USER LOGIN mylog XL USER LOGIN info XL USER LOGIN 闲聊登录信息初始化 xlLoginPara useSugram true xlLoginPara xl unionid XL USER LOGIN openId xlLoginPara xl nickname XL USER LOGIN nickName xlLoginPara xl headimgurl XL USER LOGIN smallAvatar 闲聊登录 f login xlLoginPara beginLogin true else mylog 开始进行 loginData 自动登录 loginData sys localStorage getItem loginData if loginData Comment A36 使用闲聊拉起游戏后 需要检测三次游戏邀请信息 此处为 不能自动登录时的检测 Comment A37 点击微信登录就清除 闲聊的登录信息 保证点什么登录游 戏内就是该登录方式的信息 mylog loginData 自动登录 loginData JSON parse loginData f login loginData mail loginData code beginLogin true 在不能自动登录的时候去判断并执行是否是从游戏邀请链接启动的游戏 if beginLogin jsclient native xlGetInviteGameInfo 18 在 Login js 中 LoginLayer 的 wechatLogin 事件中添加 在 login js 里自己定义一个 var iswxLogin false click function btn etype if agreeNode isSelected 点击微信登录就清除闲聊的登录信息 保证点什么登录游戏内就是该登录 方式的信息 xlLoginPara if jsclient native iswxLogin true jsclient native wxLogin else LoginAsGuest 19 在 Login js 中 LoginLayer 添加按钮 xianLiaoLogin 的事件 xianLiaoLogin visible function if cc sys OS WINDOWS cc sys os jsclient remoteCfg guestLogin jscl ient sdk control xianliao return false else return true run function doLayout this 0 6 0 13 0 5 0 5 1 2 2 click function mylog 点击闲聊登录 Comment A38 闲聊登录成功后的处 理 Comment A39 闲聊登录成功和失败 的反馈信息 if jsclient native jsclient native xlLogin 20 在 Login js 中 event 内添加 XL USER LOGIN 的事件响应 XL USER LOGIN function para mylog 接收到 XL USER LOGIN 数据 jsclient unblock if para 保存闲聊登录数据到本地 var para para data mylog 开始设置本地 XL USER LOGIN cc loader loadTxt jsb fileUtils getWritablePath XLNickName txt function er txt if txt 重置闲聊昵称 para nickName escape txt 设置大头像信息为 para originalAvatar para smallAvatar 存储闲聊信息 sys localStorage setItem XL USER LOGIN JSON stringify para jsclient operateFirstLoginType xl 闲聊登录信息初始化 xlLoginPara useSugram true xlLoginPara xl unionid para openId xlLoginPara xl nickname para nickName xlLoginPara xl headimgurl para smallAvatar 闲聊登录 mylog 开始进行闲聊登录 f login xlLoginPara 21 在 Login js 中 event 内添加 XL LOGIN MSG 的事件响应 XL LOGIN MSG function para if para errMsg switch para errMsg case ERR SUCCESS 授权成功 Comment A40 存储首次登录信息为 wx Comment dream41 存储这条信息时 要加以区分是正常的微信登录还是第 一次微信绑定登录 jsclient block break case ERR CANCEL 授权登录取消 break case ERR FAIL 授权登录失败 break case ERR UNKNOW 未知错误 break case ERR AFTERGETCODE 获取 code 之后出错 jsclient unblock break 22 在 Login js 中 event 的 WX USER LOGIN 响应事件内添加 WX USER LOGIN function para if para openid cc loader loadTxt jsb fileUtils getWritablePath nickname txt function er txt if txt para nickname escape txt sys localStorage setItem WX USER LOGIN JSON stringify para jsclient operateFirstLoginType wx 新的写法 if iswxLogin sssys localStorage setItem WX USER LOGIN JSON stringify para jsclient operateFirstLoginType wx LoginAsWeChat para 23 在 Login js 中 event 的 loginRtn 响应事件内添加 loginRtn function rtn if rtn result ZJHCode Success if code cc sys localStorage setItem loginData JSON stringify loginData Comment A42 需要微信登录去绑定 两者信息 在这里调用微信登录 var loginType jsclient operateFirstLoginType if loginType xl mylog 登录成功登录成功 2222 var para para openId xlLoginPara xl unionid para nickName xlLoginPara xl nickname para smallAvatar xlLoginPara xl headimgurl sys localStorage setItem XL USER LOGIN JSON stringify para else if rtn result ZJHCode needWxRegister 需要微信登录 if agreeNode isSelected if jsclient native iswxLogin false jsclient native wxLogin else if rtn result ZJHCode needWxId 需要微信 id jsclient showMsg 微信 id 缺失 else if rtn result ZJHCode needXlId 需要闲聊 id jsclient showMsg 闲聊 id 缺失 else if rtn result ZJHCode bindAnotherWxUser 闲聊账号绑定了另外的微信 id jsclient showMsg 此微信账号不是您的闲聊账号所绑定的微信账号 请登录 正确的微信账号 else if rtn result ZJHCode bindAnotherXlUser 微信账号绑定了另外的闲聊 id jsclient showMsg 此闲聊账号不是您的微信账号所绑定的闲聊账号 请登录 正确的闲聊账号 if unblock Comment A43 初始化 xlLoginPara Comment A44 这里注意下 闲聊的 苹果端在显示分享信息的时候没有使 用这个参数 而是在 title 里面显示的 是游戏名称 这点我会跟闲聊沟通后 让闲聊去修改 Comment A45 闲聊的邀请信息 没 有接代开房的项目这里可以略过了 Comment A46 闲聊的邀请信息 Comment A47 闲聊分享类型定义 Comment A48 闲聊信息初始化 jsclient unblock 24 在 Login js 中 ctor 函数内添加 xlLoginPara 25 在 myRooms js 中的 Button invite 的点击事件中添加 Button invite click function 设置闲聊的 para jsclient xianLiaoPara jsclient xianLiaoPara type XianLiaoType invite jsclient xianLiaoPara roomId info tableid jsclient xianLiaoPara roomToken gameType henmj jsclient xianLiaoPara title jsclient uiPara title jsclient xianLiaoPara description jsclient uiPara desc 26 在 Play js 中的邀请按钮的点击事件中添加 wxinvite click function 设置闲聊的 para jsclient xianLiaoPara jsclient xianLiaoPara type XianLiaoType invite jsclient xianLiaoPara roomId tData tableid jsclient xianLiaoPara roomToken gameType henmj jsclient xianLiaoPara title jsclient uiPara title jsclient xianLiaoPara description jsclient uiPara desc 27 在 resource js 中添加 var XianLiaoType text 1 文本分享 image 2 图片分享 invite 3 游戏邀请 jsclient xianLiaoPara 28 在 Result js 中添加 needWxId 13 需要微信 id needXlId 14 需要闲聊 id Comment A49 在这里也可以实现闲 聊和微信的绑定 bindAnotherWxUser 15 闲聊账号绑定了另外的微信 id bindAnotherXlUser 16 needWxRegister 17 需要微信注册 29 在 Update js 的 ShareWXLayer 中添加一个控件 btn xianliao btn xianliao run function click function jsclient xlCheckAndShare 30 在 Update js 的 ShareWXLayer 中的 event 添加 XL USER LOGIN XL USER LOGIN function para jsclient unblock if para 保存闲聊登录数据到本地 var para para data cc loader loadTxt jsb fileUtils getWritablePath XLNickName txt function er txt if txt 重置闲聊昵称 para nickName escape txt 设置大头像信息为 para originalAvatar para smallAvatar 存储闲聊信息 sys localStorage setItem XL USER LOGIN JSON stringify para 绑定账号 var unionid jsclient getWXunionid jsclient gamenet request pkcon handler bindSugramUser unionid unionid xl unionid para openId function rtn if rtn result ZJHCode Success 存储闲聊信息存储闲聊信息 sys localStorage setItem XL USER LOGIN JSON stringify para jsclient xlCheckAndShare else if rtn result ZJHCode needWxId 需要微信 id jsclient showMsg 微信 id 缺失 else if rtn result ZJHCode needXlId 需要闲聊 id jsclient showMsg 闲聊 id 缺失 else if rtn result ZJHCode bindAnotherWxUser 闲聊账号绑定了另外的微信