跳到主要内容

WYVRN SDK

WYVRN SDK 是一款一体化 SDK，集成了雷蛇（Razer）的所有核心技术：人工智能游戏工具（AI Gaming Tools）、Chroma RGB 幻彩灯光系统以及 Sensa HD 高清触觉技术。 WYVRN SDK 的集成流程需要与 Razer/WYVRN 团队协作完成，该团队负责设计 Chroma 灯光动画、触觉效果并提供 AI 集成支持。 点击此处通过 Discord 联系我们。 *不同于可独立使用（无需 WYVRN 团队介入）的 Chroma RGB SDK 和 Interhaptics SDK，WYVRN SDK 的集成需要直接与 WYVRN 团队合作，因为所有功能均托管在雷蛇 Synapse（雷云）平台端。游戏开发者在使用 WYVRN SDK 时，无需自行设计触觉效果或 Chroma 灯光动画 - 这些均由 WYVRN 团队负责处理。

WYVRN 提供：

  • Chroma RGB 集成与设计
  • Sensa HD 高清触觉集成与设计
  • AI 集成

概述​

WYVRN SDK 允许开发者针对游戏状态、玩家状态、技能、动作和环境等场景中的事件进行命名。外部的 WYVRN 配置系统将基于这些事件来控制 AI、Chroma 灯光和触觉反馈。

WYVRN SDK 是将 AI、Chroma RGB 灯光和雷蛇 Sensa HD 高清触觉技术融于一体的整合SDK。通过将 AI、RGB 灯光和触觉反馈集成到游戏环境和事件中，玩家能够享受到真正沉浸式的游戏体验。WYVRN SDK 能够在支持雷蛇 Sensa HD 高清触觉技术的设备上播放 Chroma 灯光动画和触觉效果。通过在游戏程序中调用 SetEventName() 方法可以单独或同时触发 AI 交互、RGB 灯光效果、触觉反馈等特效。

image-8

下载​

SDKs

  • WYVRN SDK
编码（Encoding）UNICODEASCIIMULTI-BYTE
WYVRN Design TemplateGitDownload
WYVRN C++ SDKGitDownloadGitDownloadGitDownload
WYVRN Unreal SDKGitDownload
WYVRN Unity SDKGitDownload

用户隐私​

声明： WYVRN SDK 在初始化期间仅要求用户提供最低限度的必要信息，包括：应用程序或游戏的标题、应用程序或游戏的描述、应用程序或游戏的作者以及应用程序或游戏的支持联系信息。这些信息将显示在 Synapse（雷云） 和 Chroma App（Chroma幻彩应用） 中。WYVRN SDK 不会监控或收集任何与用户相关的个人数据。

依赖项​

在开始使用 WYVRN SDK前，请先安装最新版本的 Razer Synapse 4（雷云 4）与 Chroma 幻彩应用（Chroma App）。

image-2

WYVRN SDK 库​

在每款游戏引擎的内部都提供了一个用于集成 Chroma SDK 的插件 (Chroma SDK plugin)。SDK 的初始化 (Initialization) 将会处理关于您游戏的信息，并在 Synapse（雷云）和 Chroma 幻彩应用中显示。

image-5

WYVRN SDK 集成流程​

事件设计​

事件设计（Event Design）是整个集成流程的起点。事件（Events）可以作为游戏中的触发器，用以标识游戏状态、玩家状态、环境状态、技能、道具以及动作等等。事件具有以下特性：事件触发频率上线为 30 FPS；事件可以是一次性触发（例如某个动作的执行），也可以成对出现，分别表示动作的开始与结束；事件可用于触发触觉反馈、灯光效果，或同时触发两者。为了帮助开发者理解某组游戏事件可能对应的触觉或光效表现形式，WYVRN 团队会提供一份建议事件列表。开发者可以对建议事件进行修改，或提出额外的事件需求，以进一步扩展特效的覆盖范围。WYVRN 团队在设计 Chroma 光效与触觉效果建议时的灵感通常来自游戏实机视频。如果无法提供游戏视频，开发者也可以提供描述性文案或美术参考，以帮助团队构思期望的效果。

修订流程​

部分事件的设计可以根据反馈进行修订，以补充缺失的效果或优化原有逻辑。这些调整可能涉及修改现有事件，或新增事件以扩展覆盖范围。请填写 Wyvrn_Design_Template_Developers.xlsx 模板 来提交修改/新增需求。

示例项目​

开发者需明确说明游戏所使用的引擎类型，以便团队提供对应引擎的示例项目（含参考代码）。该示例项目将展示如何在目标语言或游戏引擎中使用 WYVRN 的 API，以及对应事件设计的执行逻辑。 示例项目将包含一个插件，用于将 WYVRN SDK 集成到指定的游戏引擎中。示例代码可以根据需要进行修改，以触发事件设计中定义的任意事件。

集成方法​

集成工作的主要内容是为游戏中的各类事件添加 SetEventName() 方法调用，并为每个事件指定唯一的字符串标识。对单个开发者而言，一般集成流程耗时0至 5 天左右。事件部署完成后，Chroma灯光效果与触觉反馈可在游戏外部后端独立配置。Chroma与触觉系统相互独立，可同步或单独触发 —— 具体取决于游戏事件类型，由设计师灵活决定。

质量测试​

集成完成后，团队可为游戏构建版本提供质量测试（QA）。通过开发者提供的 Steam / Epic Store 的测试密匙（Beta Key），团队可以在游戏正式发布前进行测试。在此阶段，团队将会通过实际测试来提出设计修改建议，并根据反馈优化体验。 为了支持 QA 流程，建议开发者在游戏中提供关卡选择器，或添加控制台命令，以便快速跳转至关键触发点，验证事件是否按预期触发并准确呈现。测试密钥仅限工程团队与QA团队使用。

触觉交互设计（Haptic Design）​

在事件集成与测试完成后，设计团队将会提供初始的触感交互设计方案。添加触觉反馈不需要在游戏中增加额外资源，也无需修改原始代码，甚至可以在游戏发布后随时补充。 触觉反馈可以通过生成配置文件的方式添加。开发者可以使用 Synesthesia Console 工具，它可自动在 HapticFolders 文件夹中生成触觉配置文件，并在游戏中的事件名称符合命名规范时，自动添加一些可编辑的模拟触觉文件（可通过 Haptic Composer 编辑简易的触觉效果）。这些触觉配置文件会随着 Chroma App 的更新自动发布，无需开发者手动维护。

灯光交互设计（Chroma Design）​

Chroma灯光效果的集成同样可以完全在游戏外部完成。WYVRN 配置系统提供了对 Chroma 效果的控制支持，可用于操作指定命名事件的灯光效果播放。Chroma 配置支持以下功能：待机动画（idle）、单次播放（one-shot）或循环播放（loop）动画，以及停止当前播放中的动画。其中，单次动画播放结束后会自动切换回待机动画，以确保视觉效果的连贯。