跳转至

自定义光标

＃＃ 大纲

自定义光标 是一项功能，允许用户加载自己选择的光标形状，而不是 UI 上的典型鼠标光标。除了游戏之外，用户还可以通过将自定义光标应用于 Hive 平台提供的 UI，例如条款和条件弹出窗口、登录弹出窗口，来减少游戏和 Hive UI 之间光标样式的差异。

Note

自定义光标 功能从 {{ 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 时才会显示光标图像。

Note

从 {{ Brand_name }} SDK v4 Android 26.7.0 及更高版本开始支持自定义光标功能。