PAT0021-虚拟礼物赠送及特效触发方法——技术交底书.docVIP

PAT0021-虚拟礼物赠送及特效触发方法 赠送鱼翅类型礼物及特效实现流程： 用户赠送礼物，后台程序会在房间内广播礼物赠送消息，并根据礼物价值智能判断是否触发全站广播和宝箱玩法系统。 前端用户：client，登录到web页面的前端用户。 鱼翅交易服务：transact_sever，负责鱼翅交易。 聊天室：chatroom，集中处理弹幕、缓存与前端用户会话。 前端用户群组：clients，前端用户的集合。 ①鱼翅类型礼物赠送rpc请求： 前端用户在直播间，点击赠送礼物图标，触发赠送对应礼物的流程。改过程主要为了完成赠送鱼翅礼物的交易过程。在数据库中扣除赠送者的鱼翅数，并增加受赠者的鱼翅数。只有在交易成功后，才会展示赠送该礼物所产生的特效。 输入： ·聊天室id。（room_id，每个聊天室拥有一个唯一的id，我们简称为房间id，该输入参数为赠送礼物事件发生时，所在的房间） ·赠送者id。（src_id，每个用户拥有一个唯一的id，该输入参数为赠送礼物用户的id） ·受赠者id。（dst_id，每个用户拥有一个唯一的id，该输入参数为接受礼物用户的id，在聊天室内赠送，默认是赠送给主播） ·礼物id。（gift_id，每一种礼物都以一个唯一的id，存放于MySql数据库的礼物模版表中） ·礼物数量。（gift_count，赠送礼物的数量，默认单次赠送礼物的数量为1） ·礼物价值。（gold，在礼物模版中记录有每个礼物的价值，该输入参数为礼物中包含的鱼翅数量） 输出： ·交易成功，返回错误码0、用户账户中剩余的鱼翅数量。 ·交易失败，返回交易失败的错误码。 ②返回rpc请求结果： 由鱼翅交易服务器将赠送礼物的交易请求处理结果返回给赠送者。 输入： ·交易成功，错误码0、用户账户中剩余的鱼翅数量。 ·交易失败，返回交易失败的错误码。 输出： ·如果交易成功，前端将用户账户中剩余的鱼翅数量展示给用户。 ·如果交易失败，前端将根据错误码提示用户，提示信息包括【用户账户余额不足，请充值！】【服务器繁忙，请稍后尝试！】 ③是，发送赠送结果 将赠送鱼翅礼物的结果发送给聊天室，进行礼物特效的展示，礼物特效包括：连击特效、房间内视频区域广播、高人气房间视频区域广播、房间内开启鱼丸宝箱。每个礼物的特效都配置在MySql数据库的礼物模版表中，一个礼物可以拥有多种特效。 输入： ·房间id，（room_id，赠送礼物发生的房间，根据房间id可以找到该房间，礼物的特效将在这个房间展示） ·礼物id，（gift_id，聊天室根据礼物id从礼物模版中找到礼物对应的特效，并展示该礼物特效） ·赠送者id，（src_id，根据用户id找到赠送者的用户昵称src_nick，用与在礼物特效中展示赠送者的信息） ·受赠者id，（dst_id，根据用户id找到受赠者的用户昵称dst_nick，用于在礼物特效中展示受赠者信息） ·礼物数量，（gift_count，用于在礼物特效中展示礼物个数） 输出： ·赠送礼物连击处理，根据礼物id找到礼物的特效，判断是否拥有连击特效，默认每个礼物都有连击特效。如果有连击特效，在聊天室中，根据赠送者id（src_id）、礼物id（gift_id）在缓存中找到赠送者在一个小时以内送出的该礼物的数量，更新缓存中赠送者赠送该礼物的数量，获取更新后的数量total_gift_count。将赠送者昵称src_nick、礼物id、赠送该礼物的总数量total_gift_count广播给房间内所有的用户。前端收到该广播消息后，根据礼物id找到礼物展示所需的资源（图片、礼物名称等），展示出连击特效：src_nick送出 礼物名称 x total_gift_count。 ·高人气房间广播处理，根据礼物id找到礼物的特效，判断是否拥有高人气房间广播特效。如果有高人气房间广播特效，在聊天室中，将赠送者昵称src_nick、受赠者昵称dst_nick、礼物id、房间id、单次赠送的礼物数量gift_count打包成数据包BroadcastData，并发送给聊天管理服务，聊天室管理服务从人气（人气由房间实际人数、弹幕活跃度、赠送礼物的活跃度计算得出）最高的前100个聊天室中随机抽取50个聊天室进行广播，即将BroadcastData发送给这些聊天室，并由这些聊天室再将BroadcastData发送到在聊天室中的web前端。web前端解析BroadcastData数据包，根据礼物id礼物特效所需资源（图片、礼物名称gift_name等），在视频区域展示出广播特效：src_nick 赠送给 dst_nick gift_count个gift_name。用户点击视频区域的广播，flash会根据room_id自动在新的web页面打开房间。高人气房间广播特效，详见【赠送鱼翅礼