/** * 摄像头 OSD(屏幕叠加文字)处理工具 * * 用法: * import { setCameraOSD } from '../utils/cameraOsd.js'; * await setCameraOSD('rtsp://admin:pass@192.168.1.100:554/stream', '通道名称'); */ import { createRequire } from 'module'; import { promisify } from 'util'; import fs from 'fs'; import path from 'path'; import os from 'os'; const require = createRequire(import.meta.url); const { Cam } = require('onvif'); // ─── 文件日志 ─── function _logDir() { const appData = process.env.ProgramData || path.join(process.env.SystemDrive || 'C:', 'ProgramData'); const dir = path.join(appData, 'printServer'); if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true }); return dir; } function _writeLog(level, ...args) { const msg = args.join(' '); console.log(`[CameraOSD] ${msg}`); try { const ts = new Date().toISOString().replace('T', ' ').substring(0, 19); fs.appendFileSync(path.join(_logDir(), 'cameraOsd.log'), `[${ts}] [${level}] ${msg}\n`, 'utf-8'); } catch (_) { /* ignore */ } } const _log = (...a) => _writeLog('INFO', ...a); const _err = (...a) => _writeLog('ERR', ...a); /** * 解析 RTSP URL 提取 [用户名, 密码, 主机] * 格式: rtsp://username:password@host:port/path */ function extractRTSPInfo(rtspUrl) { const match = rtspUrl.match(/^rtsp:\/\/([^:]+):(.+)@([^:/]+)/); if (!match) { throw new Error('RTSP URL 格式无效,期望: rtsp://用户名:密码@主机:端口/路径'); } return { username: match[1], password: match[2], host: match[3] }; } /** * 给摄像头设置 OSD 文字 * @param {string} rtspUrl - 摄像头 RTSP 地址 * @param {string} osdText - 要显示的 OSD 文字 * @returns {Promise<{ok: boolean, message: string}>} */ export async function setCameraOSD(rtspUrl, osdText, posX = -0.9, posY = 0.8) { return _osdAction(rtspUrl, osdText, posX, posY, 'replace'); } /** * 清空 OSD(删除全部文本 OSD,不创建新的) */ export async function clearCameraOSD(rtspUrl) { return _osdAction(rtspUrl, '', 0, 0, 'clear'); } /** * OSD 核心操作 * @param {string} mode - 'replace'=删旧建新, 'append'=叠加追加, 'clear'=只删不建 */ async function _osdAction(rtspUrl, osdText, posX, posY, mode) { _log('收到 OSD 请求, rtspUrl:', rtspUrl.replace(/:[^:@]+@/, ':****@'), 'text:', osdText, 'pos:', posX, posY, 'mode:', mode); const info = extractRTSPInfo(rtspUrl); _log('连接摄像头:', info.host, '用户:', info.username); return new Promise((resolve) => { new Cam({ hostname: info.host, username: info.username, password: info.password, port: 2020, timeout: 10000, preserveAddress: true }, async function (err) { if (err) { _err('连接失败:', err.message); return resolve({ ok: false, message: `连接摄像头失败: ${err.message}` }); } const cam = this; try { // 转为 Promise 风格 const getOSDs = promisify(cam.getOSDs).bind(cam); const createOSD = promisify(cam.createOSD).bind(cam); const setOSD = promisify(cam.setOSD).bind(cam); const token = cam.defaultProfile.videoSourceConfiguration.$.token; _log('videoSourceConfigurationToken:', token); // 检查是否已有文本 OSD(过滤掉时间 OSD 等非 Plain 类型) let osdList = []; try { const resp = await getOSDs(token); osdList = resp?.getOSDsResponse?.OSDs || []; _log('已有 OSD 数量:', osdList.length, JSON.stringify(osdList)); } catch (e) { _err('获取已有 OSD 失败:', e.message); } // 只取 Plain 类型的文本 OSD token const textOSD = osdList.find(o => o.textString?.type === 'Plain'); const osdToken = textOSD?.$?.token; const createOptions = { videoSourceConfigurationToken: token, plaintext: osdText, position: { x: posX, y: posY } }; if (mode === 'clear') { // clear 模式:只删不建 _log('clear 模式,删除所有文本 OSD'); const deleteOSD = promisify(cam.deleteOSD).bind(cam); for (const o of osdList.filter(x => x.textString?.type === 'Plain')) { try { await deleteOSD(o.$.token); _log('已删除:', o.$.token); } catch (e) { _err('删除失败:', e.message); } } _log('clear 完成'); resolve({ ok: true, message: 'OSD 已清空', count: 0 }); return; } // replace 模式:删除已有文本 OSD,再创建新的 if (osdToken) { _log('replace 模式,删除已有文本 OSD'); const deleteOSD = promisify(cam.deleteOSD).bind(cam); for (const o of osdList.filter(x => x.textString?.type === 'Plain')) { try { await deleteOSD(o.$.token); _log('已删除:', o.$.token); } catch (e) { _err('删除失败:', e.message); } } } // 创建新 OSD,最多重试 3 次 _log('创建新 OSD, text:', osdText, 'pos:', posX, posY); for (let i = 0; i < 3; i++) { try { await createOSD(createOptions); _log('第', i + 1, '次尝试成功'); break; } catch (e) { _err('第', i + 1, '次尝试失败:', e.message); if (i === 2) throw e; } } // 验证写入 const verifyResp = await getOSDs(token); const verifyList = verifyResp?.getOSDsResponse?.OSDs || []; const textOSDs = verifyList.filter(o => o.textString?.type === 'Plain'); const verifyTexts = textOSDs.map(o => o.textString?.plainText || '').join(','); _log('验证读取 OSD: 共', textOSDs.length, '个文本, texts=[', verifyTexts, ']'); const found = textOSDs.some(o => { const txt = String(o?.textString?.plainText ?? ''); return txt === String(osdText) || txt.includes(String(osdText)); }); if (found) { _log('OK OSD 写入成功:', osdText); resolve({ ok: true, message: 'OSD 设置成功: ' + osdText, count: textOSDs.length }); } else { _err('FAIL OSD 写入失败: 期望="' + osdText + '" 实际=[' + verifyTexts + ']'); resolve({ ok: false, message: 'OSD 写入验证失败' }); } } catch (e) { _err('操作失败:', e.message); resolve({ ok: false, message: `OSD 操作失败: ${e.message}` }); } }); }); }