カスタムカーソル

概要¶

**カスタムカーソル**とは、UIに一般的なマウスカーソルではなく、ユーザーが望むカーソル形状をロードする機能です。ユーザーは、ゲームに加えて、利用規約のポップアップ、ログインポップアップなどのハイブプラットフォームで提供されるUIにカスタマイズされたカーソルを適用することで、ゲームとハイブUIの間のカーソルスタイルの異質感を減らすことができます。

Note

**カスタムカーソル**機能は、HiveSDK v4 Unity Windows 25.0.0以降で利用できます。

サポートファイル形式{ #supported-file-types }¶

カスタムカーソルでサポートされているファイル形式は次のとおりです。

CURファイル
ICOファイル
PNGファイル

動作優先順位¶

SDKからカーソルファイルをロードする優先順位は次のとおりです。

CUR、ICO、PNGファイルがすべて存在する場合：ファイル形式CUR→ICO→PNG順に各ファイルを読み、カーソルで表示します。
ファイル名（例：customcursor）が同じ場合：customcursor.cur、customcursor.ico、_customcursor.png_ファイルのうち、優先順位に基づいて最初に読み込まれたファイルだけがカーソルで表示されます。

ユーザー設定¶

カスタムカーソルを使用するには、リソースフォルダの設定とホットスパの割り当てを大きくする必要があります。

リソースフォルダの設定{ #resources-folder }¶

_Resources_フォルダの子にcustomcursor.extension形式でファイルを配置します。

ホットスポット指定{ #hotspot }¶

カーソルファイルの種類に応じたホットスパの指定方法は以下の通りです。

CURファイル：ホットスポット情報（Hotspot Information）が含まれており、これに基づいてカーソルを正確に表示します。
ICO および PNG ファイル: ホットスポット情報を含まないため、デフォルトでは座標(0,0)をホットスポットとして指定します。

注意事項{ #notes }¶

Hive SDKに**カスタムカーソル**機能を適用する場合は、次の点に注意してください。

*最大サポート解像度は256×256ピクセルです。 CUR、ICO、PNGファイルの各解像度が256 x 256ファイルを超えると、そのカーソルが正しく表示されないことがあります。

*ICOファイルとCURファイルは複数の画像サイズをサポートしますが、SDKは事前に指定されたデフォルトサイズでのみカーソルを表示します。

PNGファイルは、透明処理された領域も画像領域と見なされます。したがって、左上を (0,0) ホットスポットとして指定する際に発生する問題を回避するには、左上に透明領域を使用しないことをお勧めします。

Androidゲームコントローラをサポートするときのカーソルカスタム{ #android-cursor-custom }¶

Hive SDK v4 Androidでゲームコントローラをサポートしている場合は、Hive SDKが自己公開するカーソルの代わりにカスタムカーソルを公開できます。

Hive SDK v4 Android環境でゲームコントローラを使用するときは、SDKデフォルトカーソルの代わりにアプリで直接定義したカスタムカーソルイメージを適用できます。使用方法は以下の通りです。

カーソルイメージファイル（.png*）をプロジェクトの* res / drawable *ディレクトリサブに配置します。

*カーソル画像の左上の点が実際のクリック認識基準点になります。

*カーソル画像の元の解像度に関係なく、Hive SDK内で適切なサイズにセルフスケーリングを実行します。

*適用条件：カーソル画像は、ゲームコントローラが接続されており、Hive SDK UIが画面に公開されているときにのみ表示されます。

Note

カスタムカーソル機能は、HiveSDK v4 Android 26.7.0以降のバージョンからサポートされています。