HandyCafe Docs
owner it-admin

クライアントデスクトップの設定方法

このガイドでは、顧客がPCで見るアプリメニューの構築、ビジュアルテーマの適用、アイドル画面の設定、お知らせの公開方法を説明します。サーバーで行ったすべての変更はTCPを通じて接続クライアントに即座にプッシュされます。

アプリメニューの構築方法

アプリメニューは、顧客がセッション中に操作する画面です。カテゴリごとに整理されており、各カテゴリには1つ以上のアプリが含まれます。カタログ全体をサーバーから管理します。

必要なもの

  • 少なくとも1台のクライアントが接続された状態でHandyCafe Serverが起動していること。
  • クライアントPCにアプリの実行ファイルがインストール済みであること（GameおよびApp種別の場合）。
  • アップロード用のアイコン画像（PNG、JPG、またはWebP形式）。推奨サイズは128x128ピクセルです。

手順

  1. HandyCafe Serverアプリケーションを開き、左サイドバーの設定に移動します。
  2. 上部のクライアントタブを選択し、コンテンツサブタブに切り替えます。
  3. 左側のカテゴリパネルでカテゴリを追加ボタンをクリックします。
  4. 「ゲーム」や「ブラウザ」などのカテゴリ名を入力して確定します。新しいカテゴリがリストに表示されます。
  5. 作成したカテゴリを選択します。右側のパネルでアプリを追加をクリックします。
  6. アプリの詳細を入力します。名前（例：「Counter-Strike 2」）、任意の説明を入力し、種別フィールドを適切なタイプに設定します：Game、Browser、Link、File、またはAppです。
  7. 実行ファイルのパスフィールドに、クライアントPC上のアプリケーションへのフルパスを入力します。例：C:\Program Files\Steam\steamapps\common\CS2\cs2.exe。Link種別の場合はURLを入力します。
  8. アイコンエリアをクリックしてアイコンをアップロードします。WebからURLを貼り付けて画像を取得するか、ローカルファイルを参照することができます。アイコンはクライアントのアプリグリッドに表示されます。
  9. 任意でポスター画像をアップロードすると、より豊かなビジュアルカードになります。これはポスター優先表示モードで表示される大きなアートワークです。ヒーローカルーセルトグルを有効にすると、クライアントデスクトップ上部の回転バナーにこのアプリを表示できます。
  10. カテゴリリストまたはアプリリスト内のアイテムをドラッグして並べ替えます。アプリの横にある表示切替スイッチで、削除せずに非表示にできます。完了したら保存をクリックします。

期待される結果

接続されているすべてのクライアントデスクトップが数秒以内に更新されます。新しいカテゴリとアプリがクライアントのアプリグリッドに表示されます。顧客はカードをクリックしてアプリを起動できます。

よくある間違い

  • クライアントPC上に存在しないパスを入力する。アプリカードは表示されますが起動に失敗します。実際のクライアントマシンで実行ファイルのパスを必ず確認してください。
  • 変更後に保存を忘れる。未保存の編集内容はクライアントにプッシュされません。
  • 圧縮せずに大きすぎる画像を使用する。どの解像度でも機能しますが、512x512を超える画像はカードサイズでの視覚的メリットがないにもかかわらず同期を遅くします。

デスクトップテーマの設定方法

テーマはアクティブセッション中のクライアントデスクトップの全体的な外観を制御します。カラーテーマ、レイアウトプリセット、カード密度、背景設定を選択します。

必要なもの

  • HandyCafe Serverが起動していること。
  • 画像または動画の背景を使用する場合：PNG、JPG、WebP、MP4、またはWebM形式のメディアファイル。

手順

  1. 設定 > クライアント > 外観タブに移動します。
  2. テーマで、利用可能なカラーテーマの1つを選択します：Neon Arena（青紫のゲーミング感）、Crimson Pulse（赤みがかった暗いトーン）、Emerald Depth（緑とティールのパレット）。選択するとプレビューが更新されます。
  3. レイアウトプリセットで、画面上のコンテンツの配置方法を選択します。オプションはSplit Classic（左にカテゴリ、右にアプリ）、Hero Wide Top（上部に大きなヒーローカルーセル、下にアプリ）、Catalog Wide Bottom（コンパクトなヒーロー、広めのアプリグリッド）、Compact Focus（最小限のUI、最大のアプリスペース）です。
  4. カード密度を設定して、一度に画面に表示されるアプリ数を制御します。Largeはより詳細な大きなカードを表示します。Mediumはサイズと数量のバランスを取ります。Compactは1行に最も多くのアプリを表示します。
  5. 背景を設定します。タイプを選択します：Solid（色を選択）、Gradient（2色を選択）、Image（ファイルをアップロード）、Video（MP4/WebMをアップロード）。ImageおよびVideoタイプの場合、オーバーレイの不透明度スライダーでカード背後の背景を暗くし、ぼかしスライダーで柔らかくします。
  6. 保存をクリックします。テーマはすぐにすべての接続クライアントにプッシュされます。

期待される結果

クライアントデスクトップが新しいビジュアル設定で更新されます。テーマ、レイアウト、カードサイズ、背景がクライアントの再起動なしにすべて更新されます。

よくある間違い

  • ファイルサイズが非常に大きい動画背景を使用する。高速同期のために動画は20MB未満に保ってください。長いまたは高解像度の動画はクライアントPCで顕著な読み込み時間を引き起こします。
  • 複雑な背景画像でオーバーレイの不透明度を低くしすぎる。テキストとカードのラベルが読みにくくなります。ほとんどの画像では40〜60%のオーバーレイが適切です。

アイドル画面の設定方法

アイドル画面は、PCが使用されていないときに顧客が見る画面です。画像や動画のスライドショー、時計、カフェ名を表示できます。

必要なもの

  • スライドショー用の画像ファイル（PNG、JPG、WebP、またはGIF）または動画ファイル（MP4、WebM）。
  • HandyCafe Serverが起動していること。

手順

  1. 設定 > クライアント > アイドル画面タブに移動します。
  2. スライドショーを有効にするをオンに切り替えます。
  3. メディアを追加をクリックして画像または動画をアップロードします。複数のアイテムを追加できます。対応形式はPNG、JPG、WebP、GIF、MP4、WebMです。
  4. 各アイテムの表示時間を秒単位で設定します。これはトランジション前に各スライドが表示される時間を制御します。ほとんどの設定では8〜15秒の値が適切です。
  5. トランジション効果を選択します：Fade（滑らかな不透明度のクロスフェード）、Slide（横方向のスライド）、Zoom（ズームイン効果）。
  6. 時計オーバーレイトグルを有効にして、アイドル画面にデジタル時計を表示します。カラーピッカーを使用して、スライドショーのコンテンツに対して最大のコントラストになるよう時計テキストの色を設定します。
  7. カフェ名トグルを有効にして、アイドル画面にビジネス名を表示します。名前はサーバーの一般設定から取得されます。
  8. 保存をクリックします。アイドル画面の設定がすべての接続クライアントにプッシュされます。

期待される結果

アクティブセッション中でないクライアントPCが、設定したトランジション、時計オーバーレイ、カフェ名でスライドショーを表示します。スライドショーは継続的にループします。

よくある間違い

  • 同期時間を考慮せずに多くの高解像度画像を追加する。各メディアファイルはすべてのクライアントに転送する必要があります。スライドショーの合計サイズを適切に保ってください。
  • 表示時間を短く設定しすぎる（3秒未満）。急速なトランジションは不快に感じられ、スライド内のテキストを読むのが難しくなります。
  • すべてのスライドショー画像に対して時計の色をテストしない。白い時計は明るい白いスライドでは見えなくなります。スライドショー全体に適した色を選んでください。

お知らせの作成方法

お知らせはクライアントデスクトップに表示され、イベントの宣伝、ニュースの共有、広告の掲載に使用できます。システムはインプレッション数とクリック数を自動的に追跡します。

必要なもの

  • 少なくとも1台のクライアントが接続された状態でHandyCafe Serverが起動していること。
  • バナー画像（推奨1200x400ピクセル以上）を使用する場合はビジュアルお知らせとして表示されます。

手順

  1. 設定 > クライアント > コンテンツタブに移動します。
  2. アプリカテゴリの下にあるお知らせセクションまでスクロールします。
  3. お知らせを追加をクリックします。
  4. お知らせのタイトルとテキストを入力します。外部ページにリンクする場合は、リンクURLを入力します。
  5. 種別フィールドを設定します。一般的なニュースにはAnnouncement、インタラクティブなフォームフィールドを持つ期間限定プロモーションにはEvent、シンプルなテキストのみのメッセージにはTextを選択します。
  6. お知らせを分類するカテゴリを設定します：Link、Game、Announcement、またはAdです。これによりクライアントレイアウト上での表示場所が決まります。
  7. 画像エリアをクリックしてファイルを選択することでバナー画像をアップロードします。バナーはクライアントデスクトップのお知らせバーに表示されます。保存をクリックします。

期待される結果

お知らせが接続クライアントデスクトップのお知らせバーに表示されます。顧客が表示してインタラクションするにつれて、サーバーはインプレッション数（表示された回数）とクリック数（顧客がクリックした回数）を追跡します。

よくある間違い

  • バナー画像なしでお知らせを作成する。画像のないテキストのみのお知らせは、お知らせバーで顧客に見過ごされやすくなります。
  • 期限を設定するか古いお知らせを削除することを忘れる。古いプロモーションをアクティブのままにすると、顧客体験が悪化します。
  • お知らせ本文に非常に長いテキストを使用する。表示エリアはコンパクトです。テキストは簡潔にまとめ、詳細はリンク先に配置してください。