幽冥大陆(五十二)V10酒店门锁SDK TypeScript——东方仙盟筑基期

实现硬件交互（读卡、发卡、蜂鸣器等），而 TypeScript/Node.js 运行在 Node.js 环境中，无法直接调用 Windows 的 DLL 文件。因此转换方案分为两部分：

1. 保留核心业务逻辑和数据处理部分，用 TypeScript 实现；
2. 对于硬件交互的 DLL 调用部分，提供Node.js 调用本地 DLL 的方案（使用ffi-napi库） 作为替代，同时标注需要适配的硬件交互逻辑。

---

一、环境准备

首先需要安装 Node.js 环境，然后安装依赖包：

bash

运行

# 初始化项目（如果没有package.json）
npm init -y

# 安装TypeScript及类型定义
npm install typescript @types/node --save-dev

# 安装调用DLL的依赖（仅Windows平台可用）
npm install ffi-napi ref-napi ref-struct-napi --save

# 安装处理URL参数的依赖（对应NameValueCollection）
npm install querystring --save

二、TypeScript 转换代码

创建文件hotelDoorLock.ts，代码如下：

typescript

运行

// 引入Node.js核心模块
import * as fs from 'fs';
import * as path from 'path';
import * as querystring from 'querystring';
import { promisify } from 'util';
// 引入调用DLL的库（仅Windows平台）
import ffi from 'ffi-napi';
import ref from 'ref-napi';

// -------------------------- 类型定义 --------------------------
// 对应C#的NameValueCollection（简化版，用对象模拟）
type NameValueCollection = { [key: string]: string | undefined };

// 模拟C#的CyberWinAPPProtocolPackage协议解析类
class Cl_CyberWinAPPProtocolPackage {
    private data: { [key: string]: string } = {};

    // 解析参数字符串（模拟原逻辑，可根据实际协议扩展）
    formatString(param: string): void {
        // 假设param是类似"hotelsign=123&lockno=456789&checkingouttime=2501010000"的格式
        const parsed = querystring.parse(param);
        for (const key in parsed) {
            this.data[key] = parsed[key] as string;
        }
    }

    // 获取解析后的参数
    get(key: string): string {
        return this.data[key] || '';
    }
}

// -------------------------- 硬件交互（DLL调用） --------------------------
// 定义DLL的类型（对应原C#的DllImport）
// 注意：需要根据DLL的实际导出函数签名调整类型，这里是模拟
const ProRFLV102024Dll = (() => {
    try {
        // 加载DLL文件（路径需与原C#一致，或调整为绝对路径）
        const dllPath = path.resolve(__dirname, 'CyberWinPHP/CyberPHP_Application/CyberWin_App/CyberWin_Hotdoorlock_proV10D202409/proRFLV102024.dll');
        return ffi.Library(dllPath, {
            // 函数签名：返回值类型，[参数类型列表]
            'Buzzer': ['int', ['byte', 'int']], // Buzzer(byte fUSB, int t)
            'initializeUSB': ['int', ['int']], // initializeUSB(int d12)
            'CloseUSB': ['void', []], // CloseUSB()
            'CardErase': ['int', ['int', 'int', 'string']], // CardErase(int d12, int dlsCoID, string CardNo)（模拟，原是StringBuilder）
            'GuestCard_原始': ['int', ['int', 'int', 'int', 'int', 'int', 'int', 'string', 'string', 'string', 'string']], // 模拟原函数
            'ReadCard_v10': ['int', ['byte', 'ref']], // ReadCard_v10(byte fUSB, byte[] Buffer)（ref表示指针）
        });
    } catch (err) {
        console.error('加载DLL失败：', err);
        // 返回空对象，避免程序崩溃（实际使用时需处理）
        return {} as any;
    }
})();

// -------------------------- 核心业务类 --------------------------
class APP {
    private carddata: Buffer = Buffer.alloc(128); // 对应原byte[128]
    private 身份证照片保存路径: string = '';
    public static bufCard: Buffer = Buffer.alloc(128 + 1); // 对应原静态变量
    public static bufCard_v10: Buffer = Buffer.alloc(200 + 1); // 对应原静态变量
    public static st: number = 0; // 对应原静态变量

    // 初始化USB设备（对应原initializeUSB）
    private initializeUSB(fUSB: number): number {
        if (!ProRFLV102024Dll.initializeUSB) {
            return -1; // 表示DLL加载失败
        }
        return ProRFLV102024Dll.initializeUSB(fUSB);
    }

    // 蜂鸣器（对应原Buzzer）
    private Buzzer(fUSB: number, t: number): number {
        if (!ProRFLV102024Dll.Buzzer) {
            return -1;
        }
        return ProRFLV102024Dll.Buzzer(fUSB, t);
    }

    // -------------------------- 原方法实现 --------------------------
    // 启动方法（对应原start）
    start(obj: NameValueCollection): string {
        const 参数1 = obj['param1'] || '';
        const s = '随机预安装插件';
        return s;
    }

    // 设备状态检测（对应原status）
    status(obj: NameValueCollection): string {
        this.Buzzer(1, 50); // 蜂鸣器
        return '当你听到设备蜂鸣器,说明设备已经连接';
    }

    // 退房注销卡片（对应原checkingout）
    checkingout(obj: NameValueCollection): string {
        let s = '注销卡片';
        const param = obj['param'] || '';

        // 解析协议参数
        const clApp = new Cl_CyberWinAPPProtocolPackage();
        clApp.formatString(param);
        const 酒店标识 = clApp.get('hotelsign');
        if (!酒店标识) {
            return s + ':酒店标识为空';
        }

        // 初始化USB设备
        const st读卡器 = this.initializeUSB(1); // 1表示proUSB
        if (st读卡器 !== 0) {
            console.log('设备打开失败');
            return '打开端口失败';
        }

        // 调用注销卡片函数（模拟原CardErase，原是StringBuilder，这里用字符串模拟）
        const CardNostr = ''; // 实际使用时需传入正确的卡号缓冲区
        const st = ProRFLV102024Dll.CardErase
            ? ProRFLV102024Dll.CardErase(1, parseInt(酒店标识), CardNostr)
            : -1;

        if (st !== 0) {
            s += ':注销失败' + st.toString();
            console.log(`注销失败：${st}`);
        } else {
            s += ':成功';
        }

        // 关闭USB（原代码未显式关闭，这里补充最佳实践）
        ProRFLV102024Dll.CloseUSB && ProRFLV102024Dll.CloseUSB();

        return s;
    }

    // 入住发卡（对应原checkingin）
    checkingin(obj: NameValueCollection): string {
        let s = '酒店入住发卡';
        const param = obj['param'] || '';

        // 解析协议参数
        const clApp = new Cl_CyberWinAPPProtocolPackage();
        clApp.formatString(param);
        const 锁号服务器 = clApp.get('lockno');
        const 酒店标识 = clApp.get('hotelsign');
        const 退房时间服务器 = clApp.get('checkingouttime');

        // 校验锁号长度
        if (锁号服务器.length < 6) {
            console.log(`锁号长度错误=${锁号服务器}`);
            return s + ':锁号长度错误';
        }

        // 初始化USB设备
        const st = this.initializeUSB(1);
        if (st !== 0) {
            console.log('设备打开失败');
            return '打开端口失败';
        }

        // 构造参数
        const 开房时间s = new Date().toLocaleString('zh-CN', {
            year: '2-digit',
            month: '2-digit',
            day: '2-digit',
            hour: '2-digit',
            minute: '2-digit',
            second: '2-digit',
        }).replace(/[^\d]/g, ''); // 模拟yyMMddHHmmss格式
        const 反锁标志 = 1;
        const dai = 1; // 对应原dai变量

        // 调用发卡函数（模拟原GuestCard_原始）
        const sa1_V10字符串 = ''; // 实际使用时需传入缓冲区
        const stCard = ProRFLV102024Dll.GuestCard_原始
            ? ProRFLV102024Dll.GuestCard_原始(
                1,
                parseInt(酒店标识),
                0,
                dai,
                反锁标志,
                0,
                开房时间s,
                退房时间服务器,
                锁号服务器,
                sa1_V10字符串
            )
            : -1;

        if (stCard !== 0) {
            s += '调用发卡函数失败';
            console.log(`调用发卡函数失败：${stCard}`);
        } else {
            s += `制卡成功V2024${锁号服务器}`;
        }

        // 关闭USB
        ProRFLV102024Dll.CloseUSB && ProRFLV102024Dll.CloseUSB();

        return s;
    }

    // 读取酒店标识（对应原getsign）
    getsign(obj: NameValueCollection): string {
        // 调用读卡函数（模拟原rdCard_v10）
        if (!this.rdCard_v10()) {
            return '读卡失败';
        }

        // 调用解析函数获取酒店标识
        const 酒店标识 = CyberWin_LocakAPP.未来之窗_美萍_getsign(APP.bufCard_v10);
        return 酒店标识;
    }

    // 读卡v10（对应原rdCard_v10）
    private rdCard_v10(): boolean {
        if (!ProRFLV102024Dll.ReadCard_v10) {
            console.log('读卡函数未找到');
            return false;
        }

        // 调用DLL的ReadCard_v10（ref表示传递缓冲区指针）
        APP.st = ProRFLV102024Dll.ReadCard_v10(1, ref.ref(APP.bufCard_v10));
        if (APP.st !== 0) {
            console.log(`读卡失败${APP.st}`);
            return false;
        }
        return true;
    }

    // 写日志（对应原write_log）
    public static write_log(capturetype: string, type: string, s: string): void {
        // 构造日志路径（Node.js中替换Application.StartupPath为__dirname）
        const dateStr = new Date().toLocaleDateString('zh-CN').replace(/\//g, '-');
        const logPath = path.join(__dirname, 'log', capturetype, dateStr);

        // 创建目录（同步）
        if (!fs.existsSync(logPath)) {
            fs.mkdirSync(logPath, { recursive: true });
        }

        // 日志文件路径
        const 文件路径 = path.join(logPath, `${type}_log.log`);

        // 写入日志（追加模式）
        const logContent = `==============================\n${new Date().toLocaleString()}<<<<<<<<<<<<<<<<<<<<<<<<<<\n${s}\n\n`;
        fs.appendFileSync(文件路径, logContent, 'utf8');
    }
}

// -------------------------- 辅助类（对应原CyberWin_LocakAPP） --------------------------
class CyberWin_LocakAPP {
    // 解析酒店标识（对应原未来之窗_美萍_getsign）
    public static 未来之窗_美萍_getsign(bufCard: Buffer): string {
        const 未来之窗 = bufCard.toString('ascii'); // 对应Encoding.ASCII.GetString

        // 检查是否为空白卡
        if (CyberWin_LocakAPP.Copy(bufCard, 25, 8) === 'FFFFFFFF') {
            console.log('此卡是空白卡，请换一张能开门的卡');
            return '此卡是空白卡，请换一张能开门的卡';
        }

        // 解析酒店标识（保留原逻辑）
        const s = CyberWin_LocakAPP.Copy(bufCard, 11, 4);
        let i = parseInt(s, 16) % 16384;
        const s2 = CyberWin_LocakAPP.Copy(bufCard, 9, 2);
        i = i + (parseInt(s, 16) * 65536);

        const i2 = parseInt(CyberWin_LocakAPP.Copy(bufCard, 9, 2), 16) * 65536 + parseInt(CyberWin_LocakAPP.Copy(bufCard, 11, 4), 16) % 16383;
        const 酒店标识 = i2.toString();

        return 酒店标识;
    }

    // 字符串截取（对应原Copy方法）
    public static Copy(字符串: Buffer, 开始: number, 长度: number): string {
        const 完整 = 字符串.toString('ascii');
        开始 = 开始 < 1 ? 1 : 开始;
        return 完整.substring(开始 - 1, 开始 - 1 + 长度);
    }
}

// -------------------------- 测试代码（可选） --------------------------
// 模拟调用示例
const app = new APP();
// 测试状态检测
console.log(app.status({}));
// 测试退房（模拟参数）
console.log(app.checkingout({ param: 'hotelsign=123456' }));
// 测试入住（模拟参数）
console.log(app.checkingin({ param: 'hotelsign=123456&lockno=123456&checkingouttime=2501010000' }));

// 导出类供其他模块使用
export { APP, CyberWin_LocakAPP };

三、关键代码解释

1. 类型模拟 ：用NameValueCollection类型模拟 C# 的同名集合，用
2. DLL 调用 ：使用ffi-napi库加载 Windows DLL，模拟原 C# 的DllImport，注意函数签名需要与 DLL 实际导出的一致（代码中是模拟，需根据实际 DLL 调整）。
3. 核心业务逻辑 ：保留原有的入住发卡、退房注销、读卡、写日志等逻辑，适配 TypeScript 的语法和 Node.js 的 API（如fs模块写日志、path模块处理路径）。
4. 硬件交互适配 ：原 C# 的byte[]缓冲区用 Node.js 的Buffer替代，StringBuilder用字符串模拟（实际使用时需用ref库处理指针）。

四、编译与运行

1. 创建tsconfig.json文件（TypeScript 配置）：

json

{
    "compilerOptions": {
        "target": "ES6",
        "module": "CommonJS",
        "outDir": "./dist",
        "strict": true,
        "esModuleInterop": true
    },
    "include": ["*.ts"]
}

1. 编译 TypeScript 代码：

bash

运行

npx tsc

1. 运行编译后的 JS 代码：

bash

运行

node dist/hotelDoorLock.js

---

阿雪技术观

在科技发展浪潮中，我们不妨积极投身技术共享。不满足于做受益者，更要主动担当贡献者。无论是分享代码、撰写技术博客，还是参与开源项目维护改进，每一个微小举动都可能蕴含推动技术进步的巨大能量。东方仙盟是汇聚力量的天地，我们携手在此探索硅基生命，为科技进步添砖加瓦。

Hey folks, in this wild tech - driven world, why not dive headfirst into the whole tech - sharing scene? Don't just be the one reaping all the benefits; step up and be a contributor too. Whether you're tossing out your code snippets, hammering out some tech blogs, or getting your hands dirty with maintaining and sprucing up open - source projects, every little thing you do might just end up being a massive force that pushes tech forward. And guess what? The Eastern FairyAlliance is this awesome place where we all come together. We're gonna team up and explore the whole silicon - based life thing, and in the process, we'll be fueling the growth of technology.