feat(osd): ONVIF失败自动嗅探回退海康ISAPI协议,RTSP通道解析+坐标系转换

This commit is contained in:
liufumingren 2026-08-26 23:32:00 +08:00
parent 93198a8828
commit 7ed52dcefe

View File

@ -11,6 +11,8 @@ import { promisify } from 'util';
import fs from 'fs';
import path from 'path';
import os from 'os';
import http from 'http';
import crypto from 'crypto';
const require = createRequire(import.meta.url);
const { Cam } = require('onvif');
@ -34,15 +36,25 @@ const _log = (...a) => _writeLog('INFO', ...a);
const _err = (...a) => _writeLog('ERR', ...a);
/**
* 解析 RTSP URL 提取 [用户名, 密码, 主机]
* 解析 RTSP URL 提取 [用户名, 密码, 主机, 通道号]
* 格式: rtsp://username:password@host:port/path
* 通道解析: /stream2 → 2;/Streaming/Channels/201 → 2;默认 1
*/
function extractRTSPInfo(rtspUrl) {
const match = rtspUrl.match(/^rtsp:\/\/([^:]+):(.+)@([^:/]+)/);
const match = rtspUrl.match(/^rtsp:\/\/([^:]+):(.+)@([^:/]+)(?::(\d+))?(\/\S*)?/);
if (!match) {
throw new Error('RTSP URL 格式无效,期望: rtsp://用户名:密码@主机:端口/路径');
}
return { username: match[1], password: match[2], host: match[3] };
let channel = 1;
const pathPart = match[5] || '';
// 海康风格 /Streaming/Channels/201(第1位数字=通道号)
const hc = pathPart.match(/\/Streaming\/Channels\/(\d)\d{2}/i);
if (hc) channel = parseInt(hc[1], 10);
else {
const sm = pathPart.match(/stream(\d+)/i);
if (sm) channel = parseInt(sm[1], 10);
}
return { username: match[1], password: match[2], host: match[3], channel };
}
/**
@ -62,6 +74,207 @@ export async function clearCameraOSD(rtspUrl) {
return _osdAction(rtspUrl, '', 0, 0, 'clear');
}
/**
* 海康 ISAPI 协议 OSD 设置(当 ONVIF 不可用时回退)
* 接口: GET/PUT /ISAPI/System/Video/inputs/channels/1/overlays/text
* 认证: Basic / Digest 自适应
* @returns {Promise<{ok: boolean, message: string}>}
*/
async function _osdActionIsapi(host, username, password, osdText, posX, posY, mode, channel = 1) {
_log('[ISAPI] 开始设置 OSD host=%s mode=%s channel=%d', host, mode, channel);
try {
const ch = Number.isInteger(channel) && channel >= 1 ? channel : 1;
const baseUri = `/ISAPI/System/Video/inputs/channels/${ch}/overlays/text`;
const mainUri = `/ISAPI/System/Video/inputs/channels/${ch}/overlays`;
let auth = await _isapiAuth(host, username, password, baseUri);
if (!auth) {
return { ok: false, message: 'ISAPI 认证失败(Basic/Digest 均不可用)' };
}
// 401 时自动重新握手并重试一次(nonce 过期/stale 场景)
const authedReq = async (method, uri, body) => {
let resp = await _isapiRequest(host, method, uri, body, auth.headers(method, uri));
if (resp.status === 401) {
const newAuth = await _isapiAuth(host, username, password, baseUri);
if (newAuth) {
auth = newAuth;
resp = await _isapiRequest(host, method, uri, body, auth.headers(method, uri));
}
}
return resp;
};
// 1. 读取现有 OSD
const getResp = await authedReq('GET', baseUri, null);
_log('[ISAPI] GET overlays status=%s body=%s', getResp.status, (getResp.body || '').slice(0, 500));
if (mode === 'clear') {
// 清空:提交空列表
const emptyXml = '<?xml version="1.0" encoding="UTF-8"?>\n' +
'<TextOverlayList xmlns="http://www.hikvision.com/ver20/XMLSchema" version="2.0"></TextOverlayList>';
const putResp = await authedReq('PUT', baseUri, emptyXml);
_log('[ISAPI] clear PUT status=%s body=%s', putResp.status, (putResp.body || '').slice(0, 300));
if (putResp.status >= 200 && putResp.status < 300) {
return { ok: true, message: 'OSD 已清空 (ISAPI)', count: 0 };
}
return { ok: false, message: 'ISAPI 清空 OSD 失败: HTTP ' + putResp.status };
}
// 2. 设置文字:设备字段兼容 positionX/positionY/displayText(回读确认过)
// 坐标系:从 overlays 总接口读 normalizedScreenSize(实测 GV413 为 704x576,
// 与主码流 1920x1080 无关)。Y 轴方向:实测该设备 positionY 小=靠底部(bottom-up),
// 因此 ONVIF 归一化 posY(-1=下, +1=上)映射为 py = (1-posY)/2*H
let width = 704, height = 576;
try {
const mainResp = await authedReq('GET', mainUri, null);
const wm = /<normalizedScreenWidth>(\d+)</.exec(mainResp.body || '');
const hm = /<normalizedScreenHeight>(\d+)</.exec(mainResp.body || '');
if (wm && hm) { width = +wm[1]; height = +hm[1]; }
} catch (_) { /* 用默认 704x576 */ }
_log('[ISAPI] OSD 坐标系 %dx%d (bottom-up Y)', width, height);
// 重试链:normalized 坐标系 → 安全坐标(0,0)
const attempts = [
{ w: width, h: height },
{ w: 0, h: 0 }
];
let putResp = { status: 0, body: '' };
let xml = '';
for (const a of attempts) {
let px, py;
if (a.w === 0) { px = 0; py = 0; }
else {
px = Math.max(0, Math.min(a.w - 8, Math.round((posX + 1) / 2 * a.w)));
py = Math.max(0, Math.min(a.h - 8, Math.round((1 - posY) / 2 * a.h)));
}
xml = '<?xml version="1.0" encoding="UTF-8"?>\n' +
'<TextOverlayList xmlns="http://www.hikvision.com/ver20/XMLSchema" version="2.0">\n' +
'<TextOverlay>\n<id>1</id>\n<enabled>true</enabled>\n' +
`<positionX>${px}</positionX>\n<positionY>${py}</positionY>\n` +
`<displayText>${_xmlEscape(osdText)}</displayText>\n` +
'<isPersistentText>true</isPersistentText>\n' +
'</TextOverlay>\n</TextOverlayList>';
putResp = await authedReq('PUT', baseUri, xml);
_log('[ISAPI] set PUT(%d,%d) status=%s body=%s', px, py, putResp.status, (putResp.body || '').slice(0, 200));
if (putResp.status >= 200 && putResp.status < 300) break;
}
if (!(putResp.status >= 200 && putResp.status < 300)) {
return { ok: false, message: 'ISAPI 设置 OSD 失败: HTTP ' + putResp.status + ' ' + (putResp.body || '').slice(0, 100) };
}
// 3. 回读验证
const verifyResp = await authedReq('GET', baseUri, null);
const body = verifyResp.body || '';
_log('[ISAPI] verify GET status=%s body=%s', verifyResp.status, body.slice(0, 500));
if (mode === 'clear') {
return { ok: true, message: 'OSD 已清空 (ISAPI)', count: 0 };
}
const found = body.includes(_xmlEscape(osdText)) || body.includes(osdText);
if (found) {
_log('[ISAPI] OK OSD 写入成功:', osdText);
return { ok: true, message: 'OSD 设置成功 (ISAPI): ' + osdText, count: 1 };
}
_err('[ISAPI] FAIL 回读验证失败: 期望="' + osdText + '" body=' + body.slice(0, 300));
return { ok: false, message: 'ISAPI OSD 写入验证失败' };
} catch (e) {
_err('[ISAPI] 异常:', e.message);
return { ok: false, message: 'ISAPI OSD 操作异常: ' + e.message };
}
}
function _xmlEscape(s) {
return String(s ?? '')
.replace(/&/g, '&amp;')
.replace(/</g, '&lt;')
.replace(/>/g, '&gt;')
.replace(/"/g, '&quot;');
}
/**
* ISAPI 认证握手:先无认证请求,401 后按 WWW-Authenticate 选择 Digest 或 Basic
* @returns {Promise<{headers:(method,uri)=>Object}|null>}
*/
async function _isapiAuth(host, username, password, probeUri) {
try {
const probe = await _isapiRequest(host, 'GET', probeUri, null, {});
const wwwAuth = (probe.headers['www-authenticate'] || '') + ' ' + ((probe.body && probe.status === 401) ? '' : '');
_log('[ISAPI] 探测 status=%s WWW-Authenticate=%s', probe.status, (probe.headers['www-authenticate'] || '无').slice(0, 120));
// 有些设备直接返回 200(无认证)
if (probe.status !== 401 && probe.status !== 0) {
return { headers: () => ({}) };
}
const wa = probe.headers['www-authenticate'] || '';
if (/digest/i.test(wa)) {
const realm = /realm="([^"]*)"/i.exec(wa)?.[1] || '';
const nonce = /nonce="([^"]*)"/i.exec(wa)?.[1] || '';
const qop = /qop="([^"]*)"/i.exec(wa)?.[1] || 'auth';
const opaque = /opaque="([^"]*)"/i.exec(wa)?.[1] || '';
if (!realm || !nonce) return null;
return {
headers: (method, uri) => {
const cnonce = crypto.randomBytes(8).toString('hex');
const nc = '00000001';
const ha1 = _md5(`${username}:${realm}:${password}`);
const ha2 = _md5(`${method}:${uri}`);
const response = _md5(`${ha1}:${nonce}:${nc}:${cnonce}:${qop}:${ha2}`);
let h = `Digest username="${username}", realm="${realm}", nonce="${nonce}", uri="${uri}", response="${response}", qop=${qop}, nc=${nc}, cnonce="${cnonce}"`;
if (opaque) h += `, opaque="${opaque}"`;
return { Authorization: h };
}
};
}
// Basic
const basic = 'Basic ' + Buffer.from(`${username}:${password}`).toString('base64');
return { headers: () => ({ Authorization: basic }) };
} catch (e) {
_err('[ISAPI] 认证探测异常:', e.message);
return null;
}
}
function _md5(s) {
return crypto.createHash('md5').update(s, 'utf8').digest('hex');
}
/** 嗅探设备是否支持海康 ISAPI 协议(快速 GET /ISAPI/System/deviceInfo) */
async function _isapiProbe(host) {
try {
const resp = await _isapiRequest(host, 'GET', '/ISAPI/System/deviceInfo', null, {}, 2500);
// 200 = 无需认证;401 = 接口存在需认证;404/其他 = 不支持
if (resp.status === 200 || resp.status === 401) {
_log('[ISAPI] 嗅探成功 host=%s status=%d', host, resp.status);
return true;
}
_log('[ISAPI] 嗅探不支持 host=%s status=%d', host, resp.status);
return false;
} catch (e) {
_log('[ISAPI] 嗅探失败 host=%s: %s', host, e.message);
return false;
}
}
/** 原生 HTTP 请求(带 Content-Length,避免 chunked 被设备拒绝) */
function _isapiRequest(host, method, uri, body, headers, timeoutMs = 8000) {
return new Promise((resolve, reject) => {
const h = { ...headers };
if (body != null) {
h['Content-Type'] = 'application/xml';
h['Content-Length'] = Buffer.byteLength(body);
}
const req = http.request({ host, port: 80, path: uri, method, headers: h, timeout: timeoutMs }, (res) => {
let data = '';
res.on('data', (c) => (data += c));
res.on('end', () => resolve({ status: res.statusCode, headers: res.headers, body: data }));
});
req.on('timeout', () => { req.destroy(); reject(new Error('ISAPI 请求超时')); });
req.on('error', reject);
if (body != null) req.write(body);
req.end();
});
}
/**
* OSD 核心操作
* @param {string} mode - 'replace'=删旧建新, 'append'=叠加追加, 'clear'=只删不建
@ -69,24 +282,38 @@ export async function clearCameraOSD(rtspUrl) {
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);
_log('连接摄像头:', info.host, '用户:', info.username, '通道:', info.channel);
// 0. 先嗅探 ISAPI(海康系设备):可用则直接走 ISAPI,无需试 ONVIF
if (await _isapiProbe(info.host)) {
_log('探测到 ISAPI 协议(海康系设备),直接使用 ISAPI');
return _osdActionIsapi(info.host, info.username, info.password, osdText, posX, posY, mode, info.channel);
}
// 1. ONVIF 尝试:端口依次 80(标准)→ 2020(MIPC 等非标),全失败回退 ISAPI
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 {
const onvifPorts = [80, 2020];
const tryPort = (idx) => {
_log('尝试 ONVIF 端口:', onvifPorts[idx]);
new Cam({
hostname: info.host,
username: info.username,
password: info.password,
port: onvifPorts[idx],
timeout: 6000,
preserveAddress: true
}, async function (err) {
if (err) {
_err('ONVIF 端口 %d 失败:', onvifPorts[idx], err.message);
if (idx + 1 < onvifPorts.length) { tryPort(idx + 1); return; }
_log('ONVIF 全部失败 → 回退海康 ISAPI 协议');
resolve(await _osdActionIsapi(info.host, info.username, info.password, osdText, posX, posY, mode, info.channel));
return;
}
// ONVIF 连接成功,执行原逻辑
const cam = this;
(async () => {
try {
// 转为 Promise 风格
const getOSDs = promisify(cam.getOSDs).bind(cam);
const createOSD = promisify(cam.createOSD).bind(cam);
@ -163,13 +390,16 @@ async function _osdAction(rtspUrl, osdText, posX, posY, mode) {
_log('OK OSD 写入成功:', osdText);
resolve({ ok: true, message: 'OSD 设置成功: ' + osdText, count: textOSDs.length });
} else {
_err('FAIL OSD 写入失败: 期望="' + osdText + '" 实际=[' + verifyTexts + ']');
resolve({ ok: false, message: 'OSD 写入验证失败' });
_err('ONVIF FAIL OSD 写入失败: 期望="' + osdText + '" 实际=[' + verifyTexts + '] → 回退海康 ISAPI 协议');
resolve(await _osdActionIsapi(info.host, info.username, info.password, osdText, posX, posY, mode, info.channel));
}
} catch (e) {
_err('操作失败:', e.message);
resolve({ ok: false, message: `OSD 操作失败: ${e.message}` });
}
});
} catch (e) {
_err('ONVIF 操作失败:', e.message, '→ 回退海康 ISAPI 协议');
resolve(await _osdActionIsapi(info.host, info.username, info.password, osdText, posX, posY, mode, info.channel));
}
})();
});
};
tryPort(0);
});
}