game-sdk/simplewind/huolib/queue/controller/sdk/Role.php

<?php
/**
 * Role.php UTF-8
 * 角色处理
 *
 * @date    : 2018/5/30 16:48
 *
 * @license 这不是一个自由软件，未经授权不许任何使用和传播。
 * @author  : wuyonghong <wyh@huosdk.com>
 * @version : HUOSDK 8.0
 */

namespace huolib\queue\controller\sdk;

use huolib\queue\request\Channel;
use huolib\queue\request\Common;
use huolib\queue\request\Device;
use huolib\queue\request\Game;
use huolib\queue\request\Mem as MemRq;
use huolib\queue\request\Role as RoleRq;

class Role {
    /**
     * 角色创建
     * 记录玩家创建角色时刻的日志。
     * 在创角界面，输入完角色名后，系统显示“创角成功”即可调用该接口。
     * http://doc.1tsdk.com/138?page_id=3383
     *
     * @param Common  $com_rq
     * @param Device  $device_rq
     * @param Game    $game_rq
     * @param Channel $agent_rq
     * @param MemRq   $mem_rq
     * @param RoleRq  $role_rq
     *
     * @return bool
     */
    public function create(
        Common $com_rq, Device $device_rq, Game $game_rq, Channel $agent_rq, MemRq $mem_rq, RoleRq $role_rq
    ) {
        return (new \huo\controller\data\Role())->create($com_rq, $device_rq, $game_rq, $agent_rq, $mem_rq, $role_rq);
    }

    /**
     * 角色登录
     * 记录玩家角色登录的日志。此处应与账户登录区分。
     *
     * 在角色界面，点击“登录游戏”后进入到游戏界面时调用该接口。
     *
     * ①一个服务器下只有一个角色，没有“登录游戏”按钮，以角色登录到游戏界面时调用接口；
     *
     * ②一个服务器下可有多个角色，以执行“登录游戏”操作进入游戏界面时调用接口。
     * http://doc.1tsdk.com/138?page_id=3384
     *
     * @param Common  $com_rq
     * @param Device  $device_rq
     * @param Game    $game_rq
     * @param Channel $agent_rq
     * @param MemRq   $mem_rq
     * @param RoleRq  $role_rq
     *
     * @return bool
     */
    public function online(
        Common $com_rq, Device $device_rq, Game $game_rq, Channel $agent_rq, MemRq $mem_rq, RoleRq $role_rq
    ) {
        return (new \huo\controller\data\Role())->online($com_rq, $device_rq, $game_rq, $agent_rq, $mem_rq, $role_rq);
    }

    /**
     * 角色升级
     * 记录玩家升级的日志。玩家升级的时候调用该接口。
     * http://doc.1tsdk.com/138?page_id=3385
     *
     * @param Common  $com_rq
     * @param Device  $device_rq
     * @param Game    $game_rq
     * @param Channel $agent_rq
     * @param MemRq   $mem_rq
     * @param RoleRq  $role_rq
     *
     * @return bool
     */
    public function levelup(
        Common $com_rq, Device $device_rq, Game $game_rq, Channel $agent_rq, MemRq $mem_rq, RoleRq $role_rq
    ) {
        return (new \huo\controller\data\Role())->levelup($com_rq, $device_rq, $game_rq, $agent_rq, $mem_rq, $role_rq);
    }

    /**
     * 角色退出
     * 记录玩家角色登出的日志。此处应与账户登出区分。
     *
     * ①一个服务器只存在一个角色且不能重建的情况下，返回“选择服务器”界面即可调用该接口。
     *
     * ②一个服务器可存在多个角色，返回“选择角色”界面即可调用该接口。
     * http://doc.1tsdk.com/138?page_id=3386
     *
     * @param Common  $com_rq
     * @param Device  $device_rq
     * @param Game    $game_rq
     * @param Channel $agent_rq
     * @param MemRq   $mem_rq
     * @param RoleRq  $role_rq
     *
     * @return bool
     */
    public function offline(
        Common $com_rq, Device $device_rq, Game $game_rq, Channel $agent_rq, MemRq $mem_rq, RoleRq $role_rq
    ) {
        return (new \huo\controller\data\Role())->offline($com_rq, $device_rq, $game_rq, $agent_rq, $mem_rq, $role_rq);
    }
}