PlayEndParam.h

[詳解]

/// @file
/// @brief プレイ終了に用いるパラメータを保持するクラス PlayEndParam のヘッダ。
///
/// Copyright(C)SEGA

#ifndef AMDAEMON_PLAYENDPARAM_H
#define AMDAEMON_PLAYENDPARAM_H

#include "amdaemon/env.h"
#include "amdaemon/PlayParamHolder.h"

#include <utility>

namespace amdaemon
{
/// @addtogroup g_sequence
/// @{

    /// @brief プレイ終了に用いるパラメータを保持するクラス。
    /// @see Sequence#endPlay
    class PlayEndParam : public PlayParamHolder
    {
    public:
        /// コンストラクタ。
        PlayEndParam() : PlayParamHolder() { }

        /// @brief コピーコンストラクタ。
        /// @param[in] src コピー元。
        PlayEndParam(const PlayEndParam& src) : PlayParamHolder(src) { }

        /// @brief ムーブコンストラクタ。
        /// @param[in] src ムーブ元。
        PlayEndParam(PlayEndParam&& src) : PlayParamHolder(std::move(src)) { }

        /// @brief コピー代入演算子のオーバロード。
        /// @param[in] r 右辺値。
        /// @return 自身の参照。
        PlayEndParam& operator=(const PlayEndParam& r)
        {
            PlayParamHolder::operator=(r);
            return *this;
        }

        /// @brief ムーブ代入演算子のオーバロード。
        /// @param[in] r 右辺値。
        /// @return 自身の参照。
        PlayEndParam& operator=(PlayEndParam&& r)
        {
            PlayParamHolder::operator=(std::move(r));
            return *this;
        }

        // 下記は暗黙の定義を用いる。
        //‾PlayEndParam() = default;

        /// @brief ALL.Net課金プレイ開始パラメータを設定する。
        /// @param[in] kindCode 種別コード。 0 以上 654 以下。
        /// @param[in] statusCode 状態コード。 0 以上 99 以下。
        /// @see AccountingUnit#beginPlay
        ///
        /// @exception Exception
        /// - 引数 kindCode に 654 より大きい値を指定した場合。
        /// - 引数 statusCode に 99 より大きい値を指定した場合。
        ///
        /// このパラメータを設定するとALL.Net課金プレイ開始処理が行われるようになる。
        ///
        /// Sequence クラスのメンバ関数 Sequence#getPlayAccountingTiming の戻り値によって
        /// 下記のような違いがある。
        ///
        /// - 戻り値が PlayAccountingTiming::Normal である場合
        ///     - このパラメータは無視される。
        /// - 戻り値が PlayAccountingTiming::AtBegin である場合
        ///     - このパラメータは無視される。
        /// - 戻り値が PlayAccountingTiming::AtEnd である場合
        ///     - このパラメータを設定した場合、メンバ関数 #setAccountingEnd によって
        ///       ALL.Net課金プレイ終了パラメータも設定しなければならない。
        void setAccountingBegin(std::uint32_t kindCode, std::uint32_t statusCode)
        {
            PlayParamHolder::setAccountingBegin(kindCode, statusCode);
        }

        /// @brief ALL.Net課金プレイ終了パラメータを設定する。
        /// @param[in] kindCode 種別コード。 0 以上 654 以下。
        /// @param[in] statusCode 状態コード。 0 以上 99 以下。
        /// @param[in] itemCount 商品数。 0 以上 255 以下。 0 ならば課金しない。
        /// @see AccountingUnit#endPlay
        ///
        /// @exception Exception
        /// - 引数 kindCode に 654 より大きい値を指定した場合。
        /// - 引数 statusCode に 99 より大きい値を指定した場合。
        /// - 引数 itemCount に 255 より大きい値を指定した場合。
        ///
        /// このパラメータを設定するとALL.Net課金プレイ終了処理が行われるようになる。
        ///
        /// Sequence クラスのメンバ関数 Sequence#getPlayAccountingTiming の戻り値によって
        /// 下記のような違いがある。
        ///
        /// - 戻り値が PlayAccountingTiming::Normal である場合
        ///     - プレイ開始時やコンティニュー時に課金プレイを開始済みである場合、
        ///       必ずこのパラメータを設定しなければならない。
        ///     - 課金プレイ中ではない場合、このパラメータは無視される。
        /// - 戻り値が PlayAccountingTiming::AtBegin である場合
        ///     - このパラメータは無視される。
        /// - 戻り値が PlayAccountingTiming::AtEnd である場合
        ///     - このパラメータを設定した場合、メンバ関数 #setAccountingBegin によって
        ///       ALL.Net課金プレイ開始パラメータも設定しなければならない。
        void setAccountingEnd(
            std::uint32_t kindCode,
            std::uint32_t statusCode,
            std::uint32_t itemCount)
        {
            PlayParamHolder::setAccountingEnd(kindCode, statusCode, itemCount);
        }

    private:
        /// @brief 内部パラメータを取得する。
        /// @return 内部パラメータ。
        /// @note ライブラリ内部で用いられる。アプリ側から利用する必要はない。
        const InnerPlayParam& getInnerParam() const final override
        {
            return PlayParamHolder::getInnerParam();
        }
    };

/// @}
} // namespace amdaemon

#endif // AMDAEMON_PLAYENDPARAM_H