# 社交组件

樱花视频在线 - # 简介

本插件用于小游戏接入社交组件，给玩家在游戏内提供社交体验。包括世界频道（支持玩家间聊天，发送游戏自定义互动消息），玩家广场，直播，排行榜，通知，私信功能，可使用《星途 WeGoing》小游戏进行体验

樱花视频免费观看 - # 接入

引入插件后会自动创建一个圆形聊天按钮，浮在游戏之上，自带拖拽事件和点击事件 樱花视频在线，点击即可打开全屏聊天窗口.

接入过程中需注意：

1. 微信客户端版本低于 8.0.6 不会展示入口
2. 基础库版本低于 2.19.1 不会展示入口
3. 没有插件权限不会展示入口（平台侧设置权限）
4. 排行榜需在「MP后台-游戏能力地图-微信排行榜配置」设置中按要求配置，并正确上报数据

# 1. 申请权限

• 登录mp，前往「MP后台-能力地图-社交组件」开通权限
• 登录mp，添加插件添加地址

注：该功能仅对信用分>=100，非棋牌，捕鱼游戏开放 樱花视频高清.

# 2. 在配置中声明使用插件

在game.json中声明使用插件

___JX5_PROTECTED_code_3___

# 3. 在小游戏代码中引用

通过 requirePlugin 来调用插件的代码 注意：

1. 由于低版本基础库环境没有 requirePlugin，必须要先判断是否有 requirePlugin
2. 插件环境没有 wx，需要开发者传入

game.js

___JX5_PROTECTED_code_6___

# 4. 签名认证和设置用户发言权限(聊天鉴权用)

授权发言权限，需要先设置 signature，否则所有用户默认无法在聊天发言 樱花视频网站.

当用户打开组件时（点击入口图标或者调用open()），会获取授权信息，通过监听authorize事件 樱花视频，获取 rawData.

调用登录获取 code 樱花视频在线，和 rawData 一起发送到服务器端 或者 云函数.

在服务器端 或者 云函数中，调用 auth，code2Session 接口获取 session_key，使用 sha256，hmac(${session_key}, ${rawData}) 加密计算出签名 signature 并返回 樱花视频高清.

游戏侧获取返回的签名 signature 并设置签名信息，就可以正常使用聊天功能 樱花视频免费观看.

注意：

1. 如果有服务器，建议优先使用开发者自己的服务器完成加密签名，不使用云函数
2. 签名授权只有 1 小时，超时后会要求用户重新授权，在每次打开组件时都会要求授权防止过期
3. session_key 相关获取方法：小程序登录樱花视频网站 -
4. 不要把 session_key 下发到小游戏内，session_key 只在服务器端使用

云函数示例：

1、game.js代码片段

___JX5_PROTECTED_code_11___

2、云函数核心逻辑： cloudfunctions/verifyChatAuthorize/index. js 樱花视频网站.

___JX5_PROTECTED_code_12___

开发者还可以自己根据用户的游戏等级或者其他游戏数值去判断该用户是否有发言权限

___JX5_PROTECTED_code_13___

# 其他功能

# 1. 隐藏和显示入口

___JX5_PROTECTED_code_14___

# 2. 外层入口位置设置

1. 如果想要设置入口固定位置，可以在创建 MiniGameCenter 对象时传入{ movable: false }，来固定入口的位置，注意也要传入 x 和 y 来固定初始位置
2. 如果想要入口支持拖拽但是不会吸附到屏幕两侧，可以在创建对象时传入{ enableSnap: false }，如果游戏的两侧按钮较多，可以使用该参数

# 3. 自定义入口样式

___JX5_PROTECTED_code_17___

# 4. 自定义配置内层 tab

默认展示全部 tab 樱花视频在线，如果期望手动配置 tab，不展示某些功能，比如不想展示排行榜，可以通过 setTabs 设置.

___JX5_PROTECTED_code_18___

可选 tab 配置有:

1. 世界聊天 chat
2. 玩家广场 player
3. 直播 live （基础库版本2.21.2开始支持）
4. 排行榜 rank
5. 通知 bulletin

注意：传入数组的顺序会影响展示 tab 的顺序

# 5. 打开和关闭组件（支持打开指定 tab）

社交组件自带关闭区域，如果在某些场景下需要强制关闭组件 樱花视频免费观看，可以调用 close.

___JX5_PROTECTED_code_19___

如果需要在某些场景主动打开社交组件，可以调用 open，并且可以给 open 传参数来指定打开的 tab 页

___JX5_PROTECTED_code_20___

可选 tab 配置有:

1. 世界聊天 chat
2. 玩家广场 player
3. 直播 live （基础库版本2.21.2开始支持）
4. 排行榜 rank
5. 通知 bulletin

注意：调用 open 打开必须在组件正常显示时调用

# 6. 发送互动消息

游戏侧发送互动消息内容，丰富世界频道中消息类型，促进玩家互动

当 A 用户主动触发了 sendInteract 时，会在世界频道发送一条消息，游戏侧需要在服务器保存发送的互动消息 ID 此时 B，C 用户在世界频道看到后，主动点击了互动消息中的按钮，会触发监听事件 interact，此时游戏侧根据获取到的互动消息 ID 去服务器查询并做出对应事件

interactID 是选填的，如果不传则会自动生成一个，并在 then 中返回 开发者在服务器保存创建或返回的 interactID 作为互动事件的 ID，当其他用户触发这个 ID 时作出对应动作

___JX5_PROTECTED_code_21___

注意：调用 sendInteract 必须在组件正常显示时调用

# 7. 通知

管理员可以发布和删除通知，需先在「MP后台-能力地图-游戏圈-前往配置-基础设置-运营人员配置」设置社交组件管理员

发布通知内容后，普通用户才会展示通知 tab

# 8. 监听触发事件

___JX5_PROTECTED_code_22___

# 9. 自定义配置直播广场置顶 openid

mp 端开启一键开播功能后，组件内自动展示直播 tab，若需隐藏可以使用[GameGlobal.minigameCenter.setTabs]修改

直播 tab 支持置顶直播：在直播广场内，支持置顶，通过此 API 填入 openid 的数组，设定置顶的主播的直播，数组最多设置 4 个，超出部分截断

___JX5_PROTECTED_code_23___

# API

# Options

# Methods

# 监听事件

# sendInteractData

# getInteractData