printServer/utils/cameraOsd.js

176 lines
6.4 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

/**
* 摄像头 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}` });
}
});
});
}