kknongchang_2506/app/Module/Game/Services/RewardCollectorService.php

<?php

namespace App\Module\Game\Services;

use App\Module\Game\Logics\RewardCollectorLogic;

/**
 * 奖励数据收集服务
 * 
 * 用于收集本次请求中的所有奖励数据，包括物品奖励和代币奖励
 * 通过静态变量实现，确保在单次请求中能够累积所有奖励信息
 */
class RewardCollectorService
{
    /**
     * 添加物品奖励
     *
     * @param int $itemId 物品ID
     * @param int $instanceId 物品实例ID
     * @param int $quantity 奖励数量
     * @return void
     */
    public static function addItemReward(int $itemId, int $instanceId, int $quantity): void
    {
        RewardCollectorLogic::addItemReward($itemId, $instanceId, $quantity);
    }

    /**
     * 添加代币奖励
     *
     * @param int $coinType 代币类型
     * @param int $quantity 奖励数量
     * @return void
     */
    public static function addCoinReward(int $coinType, int $quantity): void
    {
        RewardCollectorLogic::addCoinReward($coinType, $quantity);
    }

    /**
     * 添加神像奖励
     *
     * @param int $godType 神像类型
     * @param int $diff 时间差值（秒）
     * @param int $quantity 奖励数量
     * @return void
     */
    public static function addGodReward(int $godType, int $diff, int $quantity): void
    {
        RewardCollectorLogic::addGodReward($godType, $diff, $quantity);
    }

    /**
     * 获取本次请求的所有奖励数据
     *
     * @return array 奖励数据数组，包含items和coins
     */
    public static function getRewards(): array
    {
        return RewardCollectorLogic::getRewards();
    }

    /**
     * 清空本次请求的奖励数据
     *
     * @return void
     */
    public static function clearRewards(): void
    {
        RewardCollectorLogic::clearRewards();
    }

    /**
     * 检查是否有奖励数据
     *
     * @return bool
     */
    public static function hasRewards(): bool
    {
        return RewardCollectorLogic::hasRewards();
    }
}