HandyCafe Docs
it-admin

はじめに: IT管理者

このガイドではHandyCafeの技術的なセットアップを説明します。読み終わると、サーバーとクライアントのインストール、ネットワーク設定、アプリメニューの構築、リモート管理のテストが完了します。

所要時間: 5分（クライアント展開時間を除く）

ステップ1: サーバーとクライアントのインストール

サーバーのインストール:

  1. サーバーPCがシステム要件を満たしていることを確認します。
  2. 管理用PCにHandyCafe Serverをダウンロードしてインストールします。
  3. サーバーを起動し、初回セットアップウィザードで管理者アカウントを作成します。
  4. サーバーPCのローカルIPアドレスをメモします。クライアントの接続に必要です。

クライアントのインストール（各PCで実施）:

  1. 各顧客用PCにHandyCafe Clientをダウンロードします。
  2. インストールして起動します。
  3. クライアントはmDNSディスカバリーを使用してローカルネットワーク上のサーバーを検索します。
  4. サーバーが自動的に検出されない場合は、クライアント設定でサーバーIPアドレスを手動入力します。
  5. 接続されると、クライアントがサーバーの管理パネルに表示されます。

ヒント: サーバーの自動命名機能（設定 > クライアント）を使用すると、「PC #1」「PC #2」のようなプレフィックスでクライアントを自動命名できます。表示名は後からカスタマイズ可能です。

詳細な手順はサーバーインストールおよびクライアントインストールをご覧ください。

ステップ2: ネットワーク設定の構成

サーバーで設定 > ネットワークに移動します。

HandyCafeは通信に4つのポートを使用します。

ポート デフォルト 用途
TCPポート 5001 コマンドとレスポンスの通信
ファイルポート 5002 サーバーとクライアント間のファイル転送
リモート管理ポート 5003 リモートデスクトップストリーミング制御
UDPポート 5004 画面ストリーミングデータ

設定手順:

  1. ポートを設定します（ほとんどのセットアップではデフォルト値で問題ありません）。
  2. 接続キーを設定します。HMAC-SHA256認証に使用される共有シークレットです。すべてのクライアントが同じキーを使用する必要があります。
  3. 保存をクリックします。

ファイアウォールルール:

サーバーとクライアントPCの両方で以下のポートが開いていることを確認してください。

  • TCP: 5001, 5002, 5003（サーバー側はインバウンド、クライアント側はアウトバウンド）
  • UDP: 5004（画面ストリーミング用の双方向）

重要: すべてのPCは同一ローカルネットワーク（サブネット）に接続されている必要があります。HandyCafeはクライアントディスカバリーにmDNSを使用するため、LAN接続が必要です。

すべてのネットワークオプションの詳細はネットワーク設定をご覧ください。

ステップ3: クライアントメニューのセットアップ

クライアントメニューは、顧客がデスクトップで見るアプリランチャーです。設定 > クライアント > コンテンツタブに移動します。

  1. カテゴリの作成 アプリをタイプ別にグループ化します（例: ゲーム、ブラウザー、SNS、ツール）。
  2. 各カテゴリにアプリを追加します。
    • アプリ名と説明を設定します。
    • アプリの種類を選択: ゲーム、ブラウザー、リンク、ファイル、アプリ。
    • 実行ファイルパスまたは起動URIを設定します。
    • アイコンをアップロードし、アプリカード用のポスター画像（任意）も設定します。
  3. ドラッグハンドルを使用してカテゴリやアプリを並び替えします。
  4. 表示/非表示を切り替えてアイテムを表示・非表示にします。
  5. 保存をクリックします。

変更はTCPを通じてすべての接続クライアントに自動的にリアルタイムでプッシュされます。

ヒント: IGDBとの連携を使用して、ゲームのメタデータとアイコンを自動検索できます。

クライアントメニュービルダーの詳細はクライアントメニューをご覧ください。

ステップ4: アイドル画面と外観の設定

アイドル画面（設定 > クライアント > アイドル画面タブ）:

アイドル画面は、セッションがアクティブでない時に顧客に表示されるロック画面です。

  1. アイドル画面のスライドショーを有効にします。
  2. 画像や動画を追加します（PNG, JPG, WebP, GIF, MP4, WebM）。
  3. アイテムごとの表示時間とトランジション効果（フェード、スライド、ズーム）を設定します。
  4. カスタムカラーの時計オーバーレイとカフェ名表示を有効にします（任意）。
  5. 保存をクリックします。

外観（設定 > クライアント > 外観タブ）:

セッション中に顧客が使用するオンラインデスクトップの見た目を設定します。

  1. テーマを選択: Neon Arena、Crimson Pulse、Emerald Depth。
  2. レイアウトプリセットを選択: Split Classic、Hero Wide Top、Catalog Wide Bottom、Compact Focus。
  3. 背景を設定: 単色、グラデーション、画像、動画（オーバーレイとぼかし設定付き）。
  4. カード密度（大、中、コンパクト）とホバーエフェクトを調整します。
  5. 保存をクリックします。

すべてのオプションの詳細はクライアントアイドル画面とクライアントの外観設定をご覧ください。

ステップ5: リモートデスクトップとスクリーンショットのテスト

リモート管理が機能することを確認します。

スクリーンショット:

  1. 管理パネルで任意のオンラインクライアントカードを選択します。
  2. クライアントカードのスクリーンショットをクリックします。
  3. クライアントの画面のスクリーンショットがビューアーに表示されます。
  4. スクリーンショットのダウンロードや更新が可能です。

リモートデスクトップ:

  1. オンラインクライアントカードを選択してリモートデスクトップをクリックします。
  2. ライブH.264ストリーミングのリモートデスクトップウィンドウが開きます。
  3. リモートPCのマウスとキーボードを操作できます。
  4. サーバーとクライアント間のクリップボード同期が機能します。

注: リモートデスクトップはUDPストリーミングを使用します。映像が遅延する場合は、ネットワーク帯域幅を確認し、UDPポート5004がブロックされていないことを確認してください。ストリーム設定でビットレート（350～25,000 kbps）を調整することもできます。

すべてのリモート機能の詳細はリモートデスクトップとスクリーンショットをご覧ください。

ネットワークアーキテクチャの概要

サーバーPC（管理用）
    |
    |--- TCP (5001) --- コマンド/レスポンス (bincode + HMAC-SHA256)
    |--- TCP (5002) --- ファイル転送
    |--- TCP (5003) --- リモート管理制御
    |--- UDP (5004) --- 画面ストリーミング (H.264)
    |--- mDNS ------- クライアントディスカバリー（自動）
    |
    +-- クライアントPC 1
    +-- クライアントPC 2
    +-- クライアントPC 3
    +-- ...

次のステップ