11/08/2024 16:35:55
解决方案
客户端接口部分
渠道 | 模块 | 接口名 | V5接口 | V3接口 | 备注 |
---|---|---|---|---|---|
登录 | 授权登录 | MSDKLogin::Login(); | WGLogin(); | ||
登录 | 扫码登录 | MSDKLogin::Login(); | WGQrCodeLogin(); | V5版本需要在 extraJson 中传入{"QRCode":true} |
|
好友 | 查询个人信息 | MSDKLogin::QueryUserInfo(); | WGQueryWXMyInfo(); | ||
好友 | 查询同玩好友信息 | V5版本查询同玩好友信息不提供客户端接口 |
WGQueryWXGameFriendsInfo(); | V5不提供客户端接口,直接通过 MSDK 后台接口/v2/friend/friend_list 查询 |
|
分享 | 结构化分享 | MSDKFriend.SendMessage(); | WGSendToWeixin(); | V5的消息类型为kMSDKFriendReqTypeInvite(10003) |
|
分享 | 小程序分享 | MSDKFriend.SendMessage(); | WGSendToWXWithMiniApp(); | V5的消息类型为kMSDKFriendReqTypeMiniApp(10006) |
|
分享 | 拉起小程序 | MSDKFriend.SendMessage(); | WGLaunchMiniApp(); | V5的消息类型为kMSDKFriendReqTypePullUpMiniApp(10007) |
|
分享 | 拉起微信业务,分享到微信游戏(好玩) | MSDKFriend.SendMessage(); | WGSendToWXWithOpenBusinessView(); | V5的消息类型为kMSDKFriendReqTypeOpenBusinessView(10009) |
|
分享 | 发送到微信状态 | MSDKFriend.SendMessage(); | WGSendToWXStateWithPhoto(); | V5的消息类型为kMSDKFriendReqTypeWXStatePhoto(10013) |
|
分享 | 分享到微信游戏圈 | MSDKFriend.Share(); | WGShareToWXGameline(); | ||
分享 | 分享到微信状态 | MSDKFriend.Share(); | WGSendToWXStateWithPhoto(); | V5的消息类型为kMSDKFriendReqTypeWXStatePhoto(10013) |
|
分享 | 分享到微信视频号 | MSDKFriend.Share(); | WGSendToWXChannelShareVideo(); | V5的消息类型为kMSDKFriendReqTypeWXChannelShareVideo(10011) |
|
分享 | 微信视频号直播 | MSDKFriend.Share(); | WGSendToWXChannelStartLive(); | V5的消息类型为kMSDKFriendReqTypeWXChannelStartLive(10015) |
|
分享 | 大图分享 | 至会话MSDKFriend.SendMessage(); 至朋友圈 MSDKFriend::Share |
WGSendToWeixinWithPhoto(); | V5的消息类型为kMSDKFriendReqTypeIMG(10002) |
|
分享 | 链接分享 | 至会话MSDKFriend.SendMessage(); 至朋友圈 MSDKFriend::Share |
WGSendToWeixinWithUrl(); | V5的消息类型为kMSDKFriendReqTypeLink(10001) |
|
分享 | 音乐分享 | 至会话MSDKFriend.SendMessage(); 至朋友圈 MSDKFriend::Share |
WGSendToWeixinWithMusic(); | V5的消息类型为kMSDKFriendReqTypeMusic(10004) |
|
群组 | 后端分享至微信群 | MSDKGroup::SendGroupMessage(); | WGSendToWXGroup(); | ||
群组 | 创建群 | MSDKGroup::CreateGroup(); | WGCreateWXGroup(); | ||
群组 | 加入群 | MSDKGroup::JoinGroup(); | WGJoinWXGroup(); | ||
群组 | 获取群状态 | MSDKGroup::GetGroupState(); | WGQueryWXGroupStatus(); | ||
群组 | 解绑微信群 | MSDKGroup::UnbindGroup(); | WGUnbindWeiXinGroup(); | ||
群组 | 获取群关系 | MSDKGroup::GetGroupRelation(); | WGQueryWXGroupInfo(); | V5版本 该接口只能用于查询当前登录的玩家本身与目标微信群的关系V3版本 该接口可以用于查询多名玩家与目标微信群的关系 |
|
工具 | 微信DeepLink | MSDKTools:OpenDeepLink(); | WGOpenWeiXinDeeplink(); | ||
登录 | 授权登录 | MSDKLogin::Login(); | WGLogin(); | ||
登录 | 扫码登录 | MSDKLogin::Login(); | WGQrCodeLogin(); | V5版本需要在 extraJson 中传入{"QRCode":true} |
|
好友 | 查询个人信息 | MSDKLogin::QueryUserInfo(); | WGQueryQQMyInfo(); | ||
好友 | 查询同玩好友信息 | MSDK V5版本查询同玩好友信息不提供客户端接口 |
WGQueryQQGameFriendsInfo(); | V5不提供客户端接口,直接通过 MSDK 后台接口/v2/friend/friend_list |
|
好友 | 添加 QQ 好友 | MSDKFriend::AddFriend(); | WGAddGameFriendToQQ(); | ||
分享 | 结构化分享 | MSDKFriend::SendMessage(); | WGSendToQQ(); | V5的消息类型为kMSDKFriendReqTypeInvite(10003) |
|
分享 | ark 分享 | MSDKFriend::SendMessage(); | WGSendToQQWithArk(); | V5的消息类型为kMSDKFriendReqTypeArk(10008) |
|
分享 | 小程序分享 | MSDKFriend::SendMessage(); | WGSendToQQWithMiniApp(); | V5的消息类型为kMSDKFriendReqTypeMiniApp(10006) |
|
分享 | 视频分享 | MSDKFriend::Share(); | WGSendToQQWithVideo(); | V5的消息类型为kMSDKFriendReqTypeVideo(10005) |
|
分享 | 分享纯文字到QQ空间 | MSDKFriend::Share(); | WGSendToQQWithText(); | V5的消息类型为kMSDKFriendReqTypeText(10000) |
|
分享 | 大图分享 | 至会话MSDKFriend.SendMessage(); 至空间 MSDKFriend::Share(); |
WGSendToQQWithPhoto(); | V5的消息类型为kMSDKFriendReqTypeIMG(10002) |
|
分享 | 音乐分享 | 至会话MSDKFriend.SendMessage(); 至空间 MSDKFriend::Share(); |
WGSendToWeixinWithMusic(); | V5的消息类型为kMSDKFriendReqTypeMusic(10004) |
|
分享 | 富图分享 | MSDK V5版本未提供该接口 |
WGSendToQQWithRichPhoto(); | ||
分享 | 启动手 Q 小程序 | MSDK V5版本暂未提供该接口 |
WGLaunchQQMiniApp(); | ||
分享 | 手 Q分享小世界 | MSDK V5版本暂未提供该接口 |
WGSendToQQWithCommonShare(); | ||
群组 | 创建群 | MSDKGroup::CreateGroup(); | WGCreateQQGroupV2(); | ||
群组 | 加入群 | MSDKGroup::JoinGroup(); | WGJoinQQGroupV2(); | ||
群组 | 查询 QQ 群关系 | MSDKGroup::GetGroupRelation(); | WGQueryQQGroupInfoV2(); | ||
群组 | 解绑 QQ 群 | MSDKGroup::UnbindGroup(); | WGUnbindQQGroupV2(); | ||
群组 | 绑定已存在的手 Q 群 | MSDKGroup::BindGroup(); | WGBindExistQQGroupV2(); | ||
群组 | 获取绑定的手 Q 群的群信息 | MSDKGroup::GetGroupState(); | WGGetQQGroupCodeV2(); | ||
群组 | 提醒工会会长绑群 | MSDKGroup::RemindToBindGroup(); | WGRemindGuildLeaderV2(); | ||
群组 | 获取会长的建群列表 | MSDKGroup::GetGroupList(); | WGGetQQGroupListV2(); | ||
群组 | 查询群绑定的工会 | MSDK V5版本暂未提供该接口 |
WGQueryBindGuildV2(); | ||
TPNS | 推送 | 添加本地推送 | MSDKPush::AddLocalNotification(); | WGAddLocalNotification(); | |
TPNS | 推送 | 添加本地前台推送 | MSDK V5版本暂未提供该接口 |
WGAddLocalNotificationAtFront(); | |
TPNS | 推送 | 清除所有本地推送 | MSDKPush::ClearLocalNotifications(); | WGClearLocalNotifications(); | |
TPNS | 推送 | 清除未生效本地推送 | MSDK V5版本暂未提供该接口 |
WGClearLocalNotification(); | V3的表现为:可以根据之前添加的本地推送的userInfo信息删除对应的一条未生效的推送,V5没有相应功能 |
TPNS | 推送 | 注册标签推送 | MSDKPush::SetTag(); | WGSetPushTag(); | |
TPNS | 推送 | 删除标签 | MSDKPush::DeleteTag(); | WGDeletePushTag(); | |
TPNS | 推送 | 账号绑定 | MSDKPush::SetAccount(); | WGSetPushAccount(); | |
TPNS | 推送 | 解除账号绑定 | MSDKPush::DeleteAccount(); | WGDeletePushAccount(); | |
TPNS | 推送 | 反注册 | MSDKPush::UnregisterPush(); | WGUnregisterPush(); | |
Beacon | 事件上报 | 自定义数据上报 | MSDKReport::ReportEvent(); | WGReportEvent(); | |
Bugly | 异常上报 | 上报添加额外日志回调 | OnCrashExtraMessageNotify(); | OnCrashExtMessageNotify() | |
Bugly | 异常上报 | 上报Lua/C#/JS脚本错误 | MSDKCrash::ReportException() | WGReportException(); | |
Bugly | 异常上报 | Bugly 自定义日志上报 | MSDKCrash::LogInfo(); | WGBuglyLog(); | |
Bugly | 异常上报 | 动态关闭 Bugly 上报 | MSDKCrash::CloseCrashReport(); | WGCloseCrashReport(); | |
游客 | 登录 | 游客登录 | MSDKLogin::Login(); | WGLogin(); | |
游客 | 登录 | 重置游客 | MSDKLogin::ResetGuest(); | WGResetGuestID(); | |
- | 登录 | 自动登录 | MSDKLogin::AutoLogin(); | WGLogin(); | V3调用时,传入ePlatform_None 即可实现自动登录 |
- | 登录 | 获取票据 | MSDKLogin::GetLoginRet(); | WGGetLoginRecord(); | |
- | 登录 | 异账号切换账号 | MSDKLogin.SwitchUser(); | WGSwitchUser(bool flag); | |
- | 登录 | 退出登录 | MSDKLogin::Logout(); | WGLogout(); | |
- | 登录 | 绑定 | MSDKLogin::Bind(); | 无 |
|
- | 登录 | 检测 Universal Link | MSDKLogin::CheckUniversalLink("WeChat") | WGCheckWXUniversalL(); | 当前仅支持微信渠道,V5 接口需固定传入 WeChat,V3 接口无需传参,且仅供测试环境测试使用,正式环境不可以使用此功能。 |
- | 公告 | 获取公告数据 | MSDKNotice::LoadNoticeData() | WGGetNoticeData(); | V3版本 获取公告数据是客户端端自动轮询后台拉取公告数据,然后调用接口从本地获取公告数据V5版本 获取公告数据是客户端主动向 MSDK 后台发起请求,MSDK 后台匹配参数数据后,下发公告信息给到客户端 |
- | 公告 | 隐藏滚动公告 | MSDK V5版本暂未提供该接口 |
WGHideScrollNotice(); | |
- | WebView | 打开浏览器 | MSDKWebView::OpenUrl(); | WGOpenUrl(); | |
- | WebView | 获得加密票据 | MSDKWebView::GetEncodeUrl(); | WGGetEncodeUrl(); | |
- | WebView | 打开嵌入式浏览器页面 | MSDKWebView::OpenUrl(); | WGOpenEmbeddedWebView(); | 调用 V5接口时,需要在 openUrl 接口参数中传递 extraJson = "{\"isEmbedWebView\":true}"; 等其他配置信息 |
- | WebView | 以数据的形式打开浏览器页面 | MSDK V5版本暂未提供该接口 |
WGOpenEmbeddedWebView(); | |
- | WebView | 在游戏窗口中关闭浏览器页面 | MSDKV5暂时没有提供这个接口 |
WGCloseEmbeddedWebView(); | |
- | WebView | 在游戏中发送信息到页面 js | MSDKWebView::CallJS(); | WGCallToEmbeddedWebView(); | |
- | WebView | 设置 WebView 的背景图片 | MSDKWebView::OpenUrl(); | WGSetEmbeddedWebViewBackground(); | 调用V5接口时,需要在 openUrl接口参数中传递 extraJson = "{\"isEmbedWebView\":true, \"bgPath\":"xxxxxx"}"; 等其他配置信息,其中,bgPath 即为设置 Webview 的背景图片链接 |
- | WebView | 打开AMS营销活动中心 | MSDKWebView::OpenAmsCenter | WGOpenAmsCenter(); | |
- | LBS | 获取玩家位置信息 | MSDKLBS::GetLocation(); | WGGetLocationInfo(); | |
- | LBS | 获取附近的人 | MSDKLBS::GetNearby(); | WGGetNearbyPersonInfo(); | |
- | LBS | 清除位置信息 | MSDKLBS::ClearLocation(); | WGCleanLocation(); | |
- | LBS | 根据 IP 地址获取国家信息 | MSDKLBS::GetIPInfo(); | WGGetCountryFromIP(); | |
- | 工具 | 判断App是否安装 | MSDKTools::IsAppInstall(); | WGIsPlatformInstalled(); | V3版本的接口只能用来判断微信和手 Q 客户端是否安装;V5版本的接口可以判断多个平台客户端是否安装 |
- | 工具 | 获取手Q、微信版本 | MSDKV5暂时没有提供这个接口 |
WGGetPlatformAPPVersion(); | iOS 获取不到手 Q 和微信的 App 版本 |
- | 工具 | 检查接口是否支持 | MSDKV5暂时没有提供这个接口 |
WGCheckApiSupport(); | |
- | 工具 | 获取安装渠道号 | MSDKTools::GetConfigChannel(); | WGGetChannelId(); | V3 版本 iOS 端调用这个接口会固定返回 1001;默认渠道号:73213123 V5 版本 iOS 端不提供该接口,需要业务侧写死为 1001;默认渠道号:00000000 |
- | 工具 | 获取注册渠道号 | MSDKV5暂时没有提供这个接口 |
WGGetRegisterChannelId(); | 现阶段接入 MSDK V5版本的业务获取注册渠道号是通过MSDKLoginRet 中的 regChannelDis 字段获取 |
- | 工具 | 获取MSDK版本 | MSDKV5暂时没有提供这个接口 |
WGGetVersion(); | |
- | 工具 | 用户反馈 | MSDKV5暂时没有提供这个接口 |
WGFeedback(); | |
- | Prajna | 打开中控网页 | MSDKTools::OpenPrajnaWebView(); | WGOpenFullScreenWebViewWithJson(); | |
- | Prajna | Prajna 上报 | MSDKTools::ReportPrajna(); | WGReportPrajna(); | |
- | 省流量更新 | 检查应用宝是否安装 | MSDKV5暂时没有提供这个接口 |
WGCheckYYBInstalled(); | |
- | 省流量更新 | 查询当前应用是否有更新 | MSDKV5暂时没有提供这个接口 |
WGCheckNeedUpdate(); | |
- | 省流量更新 | 开始省流量更新 | MSDKV5暂时没有提供这个接口 |
WGStartSaveUpdate(); |
后台接口部分
渠道名 | 模块 | 接口名 | V5接口 | V3接口 | 备注 |
---|---|---|---|---|---|
登录 | 手 Q 鉴权 | /v2/auth/verify_login | /auth/verify_login | ||
登录 | PC 端手 Q 鉴权 | /v2/auth/verify_login | /pclogin/qq_check_ctk | V5版本 PC SDK 形式授权,需要在 json body 中新增 "client_os":5;PC Web 形式授权获取的 token 与手游授权获取的 token 类型一致,无需额外处理 |
|
登录 | 获取pf和pfkey | /v2/auth/get_pfval | /auth/get_pfval | ||
关系链 | 用户信息 | /v2/profile/userinfo | /relation/qqprofile | ||
关系链 | 同玩好友 | /v2/friend/friend_list | /relation/qqfriends_detail | ||
关系链 | 好友信息(未注册该应用) | /v2/friend/recall_friends_list | /relation/qq_unreg_friends | 未接入的游戏暂停接入申请;已接入使用的项目组,在游戏内该接口将返回“无推荐好友”的空数据 |
|
关系链 | 好友信息 | 后台接口未提供 |
/relation/qqstrange_profile | 1.此接口目前仅供开发了“附近的人”等功能的游戏使用 2.即需要先在客户端获取到同玩陌生人 openid 列表才能调用此接口 |
|
关系链 | 获取 VIP 信息 | /v2/profile/query_qq_vip | /profile/query_vip | ||
关系链 | 蓝钻礼包 | 后台接口未提供 |
/profile/get_gift | ||
关系链 | wifi 资格 | 后台接口未提供 |
/profile/get_wifi | ||
个人信息 | 会员信息 | /v2/profile/query_qq_friends_vip | /relation/qqfriends_vip | V3 好友非好友均支持V5 仅支持查询好友的会员信息 |
|
个人信息 | 会员详情 | /v2/profile/query_qq_vip_richinfo | /relation/get_vip_rich_info | ||
个人信息 | 获取玩家实名注册后首次登录标识 | 后台接口未提供 |
/profile/qqget_first_reg | ||
个人信息 | 获取腾讯视频会员信息 | 后台接口未提供 |
/profile/qqget_video_vip | ||
个人信息 | 获取心悦超 R 玩家会员标识 | /v2/profile/query_xinyue_super | /profile/get_xinyue_super | ||
个人信息 | 获取心悦微信平台玩家会员标识 | /v2/profile/query_wx_xinyue_vip | /profile/get_wx_xinyue_vip | ||
群组 | 工会绑群 | /v2/group/create_bind_group | /relation/createbind_groupv2 | ||
群组 | 群关系查询 | /v2/group/get_group_rela_info | /relation/get_groupinfov2 | ||
群组 | 加群 | /v2/group/join_group | /relation/join_groupv2 | ||
群组 | 解绑群 | /v2/group/unbind_group | /relation/unlink_groupv2 | ||
群组 | 拉取 QQ 群列表接口 | /v2/group/get_group_list | /relation/get_group_listv2 | ||
群组 | 绑定已创建的 QQ 群接口 | /v2/group/bind_existing_group | /relation/bind_existing_groupv2 | ||
群组 | 提醒会长绑群接口 | /v2/group/remind_leader_bind | /relation/query_bind_unionv2 | ||
群组 | 拉取群信息 | /v2/group/get_group_info | /relation/get_groupcode | ||
群组 | 查询群绑定的工会 | MSDK V5暂未提供该接口 |
/relation/query_bind_unionv2 | ||
群组 | 发送群消息 | /v2/group/send_group_msg | /relation/send_groupmsg | 调用此接口的业务,需要在手 Q 申请权限,配置回调地址,如果业务没有申请权限,调用返回 {"is_lost":0,"msg":"invalid appid","ret":-2} |
|
成就 | 成就上报 | /v2/acvm/report | /profile/qqscore_batch | ||
分享 | 后台分享 | /v2/friend/share | /share/qq | 该接口平台侧已不再接受游戏接入 | |
分享 | ark 后台分享 | /v2/friend/ark_share | /share/qqark | ||
Guest | 登录 | 游客鉴权 | /v2/auth/verify_login | /auth/guest_check_token | |
Apple | 登录 | Apple 鉴权 | /v2/auth/verify_login | /auth/apple_verify | |
登录 | 微信鉴权 | /v2/auth/verify_login | /auth/check_token | ||
登录 | PC 端微信鉴权 | /v2/auth/verify_login | /pclogin/wx_check_ctk | V5版本 PC SDK 形式授权,需要在 json body 中新增 "client_os":5;PC Web 形式授权获取的 token 与手游授权获取的 token 类型一致,无需额外处理。 |
|
关系链 | 同玩好友信息 | /v2/friend/friend_list | /relation/wxprofile | ||
关系链 | 好友 openid | 后台接口未提供 |
/relation/wxfriends | ||
个人信息 | 个人信息 | /v2/profile/userinfo | /relation/wxuserinfo | ||
个人信息 | 获取特权 | 后台接口未提供 |
/profile/wxget_vip | ||
个人信息 | 获取玩家实名注册后首次登录标识 | 后台接口未提供 |
/profile/wxget_first_reg | ||
个人信息 | 获取腾讯视频会员信息 | 后台接口未提供 |
/profile/wxget_video_vip | ||
群组 | 查询群成员信息 | /v2/group/get_group_rela_info | /relation/wxget_groupinfo | ||
群组 | 解绑群 | /v2/group/unbind_group | /relation/wxunlink_group | ||
群组 | 查询群状态 | /v2/group/get_group_info | /relation/wxget_groupstatus | ||
群组 | 发送群消息 | /v2/group/send_group_msg | /relation/wxsend_groupmsg | ||
成就 | 成就上报 | /v2/acvm/report | /profile/wxbattle_report | ||
消息订阅 | 消息订阅 | /v2/profile/subscribe_getlist | /profile/subscribe_getlist | ||
消息订阅 | 批量订阅 | /v2/profile/subscribe_setlist | /profile/subscribe_setlist | ||
消息订阅 | 订阅推送 | /v2/profile/subscribe_push | /profile/subscribe_push | ||
消息订阅 | 订阅清理 | /v2/profile/subscribe_clear | /profile/subscribe_clear | ||
精英查询 | 精英查询 | /v2/profile/get_eliteinfo | /profile/wxget_eliteinfo | ||
- | 免流量 | 查询免流量 | /v2/freeflow/isfree | /freeflow/getinfo | |
- | 免流量 | 查询 IP 的信息 | 后台接口未提供 |
/freeflow/get_ccinfo |
Copyright © 2024 MSDK.
All rights reserved.
All rights reserved.