自訂遊標

＃＃ 大綱

自訂遊標 是一項功能，可讓使用者載入自己選擇的遊標形狀，而不是 UI 上的典型滑鼠遊標。除了遊戲之外，用戶還可以透過將自訂遊標應用於 Hive 平台提供的 UI，例如條款和條件彈出窗口、登入彈出窗口，來減少遊戲和 Hive UI 之間遊標樣式的差異。

自訂遊標 功能從 {{ Brand_name }} SDK 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 }¶

將customcursor.extension格式的檔案放置在 Resources 資料夾下。

指定熱點{ #hotspot }¶

根據遊標檔案類型的熱點指定方法如下。

• CUR檔案：包含熱點訊息，因此遊標根據此準確顯示。

• ICO 和 PNG 檔案：它們不包含熱點訊息，因此預設以座標(0,0)作為熱點。

注意{ #notes }¶

將 自訂遊標 功能套用至 Hive SDK 時，請記住以下幾點。

• 支援的最大解析度為 256x256 像素。如果每個 CUR、ICO 或 PNG 文件的分辨率超過 256x256 文件，則相應的遊標可能無法正確顯示。

• 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 時才會顯示遊標影像。

從 {{ Brand_name }} SDK v4 Android 26.7.0 及更高版本開始支援自訂遊標功能。