レガシークライアント
HandyCafe は、同じサーバー上でモダンなクライアントと並行して V3 / V4 クライアントのインストールを管理できます。レガシークライアントは管理パネル内で独自のカードタイプとして表示され、元のプロトコルで対応している操作に合わせた縮小版のアクションセットを持ちます。
レガシークライアントが管理パネルに表示されるようにするには、まず 設定 > レガシークライアント でランタイムサポートを有効にしてください。
レガシークライアントの見え方
レガシークライアントは、元の UDP マルチキャストプロトコルを通じてサーバーへ接続します。モダンクライアントのように mDNS は使いません。代わりに、サーバーは 2 つの方法で検出します。
| 検出経路 | きっかけ |
|---|---|
| TCP Login | クライアントが TCP コマンドポートへ LoginRequest を送信します。サーバーは相手を記録し、接続イベントを発行します。 |
| UDP Ping | クライアントがマルチキャストグループへ Ping フレームをブロードキャストします。サーバーはそれを受信し、相手レコードを更新して、オンラインイベントを発行します。 |
MAC ごとの状態は、IP、ホスト名、ログイン中ユーザー、クライアントバージョン、セッションタイマー、最終検出時刻を持つレガシークライアントストアに保持されます。受信するすべてのフレームで無通信タイマーがリセットされます。既定の 10 秒以内に通信が来なければ、クライアントはオフラインと見なされます。レコードは履歴を失わないようデータベースに残ります。
レガシークライアントカード
各レガシークライアントは、モダンクライアントカードとは別のカードとして表示されます。ヘッダーには、表示名（あればホスト名、なければ MAC）、オンラインまたはオフラインの色付きバッジ、ステータスラベルが表示されます。
ステータスの色とラベル
| ステータス | 色 | 意味 |
|---|---|---|
| Online | 緑 | アクティブなセッションが動作中です。 |
| Idle | シアン | 接続済みで待機中です。セッションはありません。 |
| Paused | アンバー | セッションが一時停止中です。課金は停止しています。 |
| Busy | 紫 | クライアントが処理中です。 |
| Payment | ローズ | クライアントが支払いフロー中です。 |
| Admin | インディゴ | 管理モードまたはメンテナンスモードです。 |
| Offline | グレー | 最近の通信がありません。クライアントが戻るまで操作は無効です。 |
| Timed | スカイ | 期限付きセッションが実行中です。 |
セッションクロック
セッションがアクティブなとき、カードには時計ブロックが表示されます。
- 開始時刻。
- 終了時刻（時間制限付きセッションの場合）。
- 使用分数。
- ライブカウントダウン付きの残り分数。
- 累積コスト。
識別情報
カードには常に次が表示されます。
- MAC アドレス。
- IP アドレス。
- クライアントバージョン（例:
3.4.01）。 - ログイン中ユーザー（いる場合）。
アクションツールバー
クライアントがオンラインのとき、識別情報の下にあるアクションツールバーで利用可能な操作を行えます。
セッション制御
| ボタン | 表示条件 | 挙動 |
|---|---|---|
| Login | 状態が idle のとき | Device Login ダイアログを開きます。分数と支払い方法を選ぶと、選択内容付きで Login コマンドが送信され、クライアント側でセッションが開始します。 |
| Logout | 状態が online、timed、paused、busy、payment のとき | セッションが後払いなら、支払いダイアログで金額と方法を入力します。取引が元帳に記録され、サーバーは Logout コマンドを送ります。クライアント側でセッションが閉じます。 |
Add Time
分数ピッカーを開きます。正の値（延長）と負の値（減算）の両方を受け付けます。上下どちらの方向でも最大値は 10,000 分です。前払いと後払いの両方のセッションで使えます。
料金設定でプリセットの分数値を設定している場合、カードにはプリセットボタンも表示されます。ピッカーを開かずに値を適用したいときは、そのボタンをタップします。
Screenshot
ファイル転送ポートを通じて、レガシークライアントからライブスクリーンショットを要求します。流れは次のとおりです。
- サーバーがスクリーンショット要求コマンドを送信します。
- クライアントは一時的なポートで短命の TCP リスナーを開きます。
- サーバーが接続し、9 バイトのファイル転送ヘッダーを送り、待機します。
- クライアントが画面をキャプチャし、圧縮 BMP としてエンコードして返送します。
- サーバーが BMP を展開し、HandyCafe データディレクトリ内の
legacy_screenshotsフォルダに保存します。 - スクリーンショットビューアーが新しい画像で開きます。
クライアントがタイムアウト内に応答しない場合（接続 30 秒、データ 20 秒が既定）、要求は失敗し、エラートーストが表示されます。すぐに再試行できます。
電源操作
| 操作 | 確認 | 効果 |
|---|---|---|
| Logoff | なし | クライアント機の Windows ユーザーをログオフします。Windows セッションは終了しますが、PC の電源は入り続けます。 |
| Reboot | あり | 再起動コマンドを送信します。クライアント機が再起動します。 |
| Shutdown | あり | シャットダウンコマンドを送信します。クライアント機の電源が切れます。 |
Reboot と Shutdown は、誤操作を防ぐため確認ダイアログを表示します。
未対応の操作
レガシークライアントは、モダンな HandyCafe クライアントで利用できるすべての機能をサポートしているわけではありません。主な差分は次のとおりです。
- セッション途中の一時停止調整なし。 セッションが一時停止中に送られた時間変更はキューに入りますが、クライアントが無視する場合があります。先に再開し、変更を適用してから、必要なら再度一時停止してください。
- サーバーコマンドによる Admin モード切り替えなし。 クライアント内部の管理者状態は、サーバーから切り替えられません。Admin モードはクライアント機上でのみ制御されます。
- サーバーからのライセンス登録なし。 サーバーはクライアントフレームで見えるライセンスバイトをミラーリングしますが、新しいライセンスをクライアントへ送ることはできません。登録はローカルで行ってください。
- レガシークライアントで開始したセッションへのメンバーウォレット統合なし。 支払いは、
transaction_type=sessionsとクライアント MAC を持つ通常のtransactions行として記録されます。モダンなウォレットフローは適用されません。 - リモートデスクトップなし。 リモートデスクトップ機能は UDP ストリーミング経路を使いますが、レガシークライアントには存在しません。
- File Sync のプッシュなし。 Sync Explorer がファイルをプッシュするのはモダンプロトコルのみです。
完全な機能を使うには、可能なタイミングでモダンな HandyCafe クライアントへ移行してください。
オフライン時の挙動
無通信タイムアウトが切れると、カードは暗くなり、ステータスバッジはグレーになり、すべてのアクションボタンが無効になります。クライアントレコードはストアに残るため、履歴、MAC、ホスト名、最終検出情報は保持されます。クライアントが再びオンラインになると（新しい UDP Ping または TCP Login）、カードは復帰し、操作が再び使えるようになります。
レコードは自動では削除されません。古いクライアントを完全に削除するには、管理データベースから編集するか、該当する管理ツールで削除してください。
ヒント
- 無通信タイムアウトは、レガシークライアントがそれより遅くビーコンを出すことが分かっている場合を除き、10 秒のままにしてください。短すぎると、短いネットワーク障害でも正常なクライアントをオフラインと誤判定します。
- レガシークライアントがオンラインに見えるのにコマンドへ反応しない場合は、設定の Protocol Variant を確認してください。サーバーバリアント（STE と Standard）とクライアントビルドが一致しないと、コマンドは黙って落ちます。
- レガシークライアントのスクリーンショットは圧縮 BMP で、モダンな PNG キャプチャよりサイズが大きくなります。大量に撮る場合は、
legacy_screenshotsフォルダを十分な空き容量のあるドライブに置いてください。 - シフト切り替え時にはプリセットボタン付きの Add Time を活用してください。ワンタップで所定の分数を延長でき、手で分数を入力するより速くなります。
- レガシークライアントは段階的に廃止してください。1 バッチずつ移行し、新しいクライアントが管理パネルで同じように動くことを確認してから、古いものを停止しましょう。