开始使用 VerseGrip 触控笔

VerseGrip 触控笔

VerseGrip 触控笔采用专有的高速无线通信技术，可实现方向追踪和手持输入/输出（I/O）功能。该产品专为满足多种应用场景的需求而设计，具有极高的通用性。

客户支持

如果您对设备或其操作有任何问题或疑虑，请联系我们的支持团队寻求帮助。VerseGrip 触控笔包含复杂的专有无线技术。打开设备将使您的保修失效，并可能导致设备无法使用。为避免延长运输时间和昂贵的维修费用，请勿打开设备。

VerseGrip 触控笔的设置和校准

本节概述了插入加密狗、打开 VerseGrip 触控笔和校准的步骤。

设置

开机和校准

重新校准

校准过程会重置 VerseGrip 的坐标系，使得校准期间握持设备时的方向成为新的参考轴。

以下演示对比了设备未校准时与已校准时的行为表现。在进行演示时，必须按照图示配置握持VerseGrip，然后才能进行校准。

待机和关机

充电

警告：如果您拥有的VerseGrip触控笔是在2024年8月至12月期间发货的——请勿让电池完全放电。一旦电量耗尽，电池可能无法再次充电。如果发生这种情况，只要VerseGrip触控笔保持连接电源，它就能继续工作。请Haply 以获取固件更新文件，从而解决此问题。

状态和指示灯

继承状态和指示灯

以下状态指示灯对应VersaGrip笔在之前版本中使用的状态和颜色(微软件1.10及更早版本)。

代码示例

以下是一个关于如何在 C++ 中使用 VerseGrip 触控笔的简单示例。

                
                #include <external/libhv.h>

                #include <nlohmann/json.hpp>

                #include <chrono>
                #include <cstdio>
                #include <string>

                using namespace hv;
                using json = nlohmann::json;

                // Procedure to get the first detected and available Wired VerseGrip Stylus device id
                std::string get_first_verse_grip_device_id(const json &data) {
                    const auto& vgs = data["wireless_verse_grip"];

                    if (vgs.empty()) {
                        return "";
                    }

                    return vgs.items().begin().key();
                }

                int main() {
                    const auto print_delay = std::chrono::milliseconds(100);
                    auto current           = std::chrono::high_resolution_clock::now();
                    bool first_message     = true;
                    std::string device_id;

                    WebSocketClient ws;

                    ws.onmessage = [&](const std::string &msg) {
                        json data = json::parse(msg);

                        if (first_message) {
                            first_message              = false;
                            const std::string first_id = get_first_verse_grip_device_id(data);

                            if (first_id.empty()) {
                                printf("no Wireless VerseGrip found.\n");
                                ws.close();
                                return;
                            }

                            device_id = first_id;
                        }

                        if (device_id.empty() || !data["wireless_verse_grip"].contains(device_id)) {
                            return;
                        }

                        const auto now = std::chrono::high_resolution_clock::now();

                        if (std::chrono::high_resolution_clock::now() > current + print_delay) {
                            current          = now;
                            const json state = data["wireless_verse_grip"][device_id];

                            printf("Rotation : { x:%f, y:%f, z:%f, w:%f }, Hall:%i, Button : [%d, %d, %d], Battery: {%f}\n",
                                state["orientation"]["x"].get<float>(),
                                state["orientation"]["y"].get<float>(),
                                state["orientation"]["z"].get<float>(),
                                state["orientation"]["w"].get<float>(),
                                state["hall"].get<int8_t>(),
                                state["buttons"]["a"].get<bool>(),
                                state["buttons"]["b"].get<bool>(),
                                state["buttons"]["c"].get<bool>(),
                                state["battery_level"].get<float>());
                        }
                    };

                    ws.open("ws://localhost:10000");

                    printf("Press ENTER to stop...\n\n");
                    while (std::cin.get() != '\n') {
                    }

                    if (ws.isConnected()) {
                        ws.close();
                    }

                    return 0;
                }