ビデオゲームのクレジット処理に統合された特殊デバイスを操作するクラス。 [詳解]

公開メンバ関数
	CreditSpecialDevice (InnerIndexHolder)
	コンストラクタ。 [詳解]

bool	isAvailable () const
	特殊デバイス機能を利用可能であるか否かを取得する。 [詳解]

bool	isLockoutOn () const
	現在ロックアウトが有効であるか否かを取得する。 [詳解]

bool	lockout (bool on)
	ロックアウト設定を行う。 [詳解]

詳解

ビデオゲームのクレジット処理に統合された特殊デバイスを操作するクラス。

このクラスのインスタンスをアプリ側で直接生成することはできない。 Credit クラスのメンバ関数 Credit::getSpecialDevice から取得すること。

一部の関数は処理完了まで呼び出し元スレッドをブロックする。

現実装では、電子コインセレクター AS-6DB-S1 の操作のみをサポートする。

電子コインセレクター AS-6DB-S1 利用時の注意事項

Daemonプロセスの初期化完了時点ではロックアウトが有効になっている。
- 適宜メンバ関数 lockout でロックアウト設定を行うこと。
デバイスエラー発生中、自動的にロックアウトが有効になる。
- デバイスエラーの中には進行停止エラーとはならないものも含まれる。現在のロックアウト状態はメンバ関数 isLockoutOn で確認すること。
デバイスエラー発生中はメンバ関数 lockout でのロックアウト設定が必ず失敗する。
- デバイスエラーが内部でリセットされ、ロックアウト設定が成功するまで、毎フレーム試行することが望ましい。

構築子と解体子

amdaemon::CreditSpecialDevice::CreditSpecialDevice ( InnerIndexHolder )

explicit

コンストラクタ。

bool amdaemon::CreditSpecialDevice::isAvailable ( ) const

特殊デバイス機能を利用可能であるか否かを取得する。

戻り値

true	利用可能である場合。
false	機能が無効である場合。

現実装では、電子コインセレクター AS-6DB-S1 の操作をサポートするか否かを返す。

bool amdaemon::CreditSpecialDevice::isLockoutOn ( ) const

現在ロックアウトが有効であるか否かを取得する。

戻り値

true	ロックアウトが有効である場合。
false	ロックアウトが無効であるか、機能が無効である場合。

デバイスの仕様により自動的にロックアウトが有効になる場合がある。進行停止エラーとはならない場合もあるため、アプリからは突然ロックアウトされたように見える。

この関数の戻り値を毎フレーム確認し、アプリの想定するロックアウト状態と異なっている場合はメンバ関数 lockout を用いてロックアウト設定を行うこと。その際、内部状態次第ではロックアウト設定に失敗する場合があるため、成功するまで毎フレーム試行し続けること。

bool amdaemon::CreditSpecialDevice::lockout ( bool on )

ロックアウト設定を行う。

引数

[in] on ロックアウトを有効にするならば true 。無効にするならば false 。

戻り値

true	処理に成功した場合。
false	処理に失敗したか、機能が無効である場合。

毎フレーム呼び出されることを想定した設計になっている。

一度呼び出すと数フレームの間はロックアウト設定処理中となり、処理中に再度呼び出した場合は何もせずに false を返す。

ロックアウト設定処理中以外でも、内部状態次第でロックアウト設定に失敗する場合があるため、必ずこの関数の戻り値やメンバ関数 isLockoutOn の戻り値を確認すること。

このクラス詳解は次のファイルから抽出されました: