wrplayer 1.0.0

package/core/PTZController.js

@@ -0,0 +1,462 @@
+/**
+ * PTZ Controller - PTZ云台控制核心模块
+ * 支持方向控制、变焦、聚焦、预置点管理等功能
+ */
+
+class PTZController {
+  /**
+   * 创建PTZ控制器实例
+   * @param {Object} config - PTZ配置
+   * @param {string} config.apiUrl - SIP服务器地址
+   * @param {string} config.apiKey - API认证密钥
+   * @param {string} config.deviceId - 设备ID
+   * @param {string} config.channelId - 通道ID
+   * @param {boolean} [config.debug=false] - 是否启用调试
+   * @param {boolean} [config.useProxy=true] - 是否使用代理（避免CORS）
+   */
+  constructor(config) {
+    this.config = {
+      debug: false,
+      useProxy: true,
+      ...config
+    };
+
+    if (!this.config.apiUrl) {
+      throw new Error('PTZController: apiUrl is required');
+    }
+
+    this.eventHandlers = {};
+    this.isMoving = false;
+    this.currentSpeed = 50; // 默认速度50%
+
+    // 预置点管理
+    this.preset = new PTZPresetManager(this);
+    // 巡航管理
+    this.cruise = new PTZCruiseManager(this);
+    // 扫描管理
+    this.scan = new PTZScanManager(this);
+
+    this._log('PTZ Controller initialized', this.config);
+  }
+
+  /**
+   * 发送PTZ API请求
+   * @private
+   * @param {string} endpoint - API端点
+   * @param {Object} params - 请求参数
+   * @returns {Promise} - API响应
+   */
+  async _request(endpoint, params = {}) {
+    try {
+      let url;
+      
+      if (this.config.useProxy && typeof window !== 'undefined') {
+        // 使用Next.js代理
+        url = `/api/ptz/${endpoint}`;
+      } else {
+        // 直接请求
+        url = `${this.config.apiUrl}/api/front-end/${endpoint}`;
+      }
+
+      // 添加查询参数
+      const searchParams = new URLSearchParams(params);
+      const fullUrl = `${url}?${searchParams}`;
+
+      const headers = {
+        'Content-Type': 'application/json',
+      };
+
+      // 添加API Key认证 - 只使用SIP服务器需要的格式
+      if (this.config.apiKey) {
+        headers['api-key'] = this.config.apiKey;
+      }
+
+      this._log('PTZ API Request:', fullUrl);
+      this._log('PTZ API Headers:', JSON.stringify(headers, null, 2));
+
+      const response = await fetch(fullUrl, {
+        method: 'GET',
+        headers
+      });
+
+      if (!response.ok) {
+        throw new Error(`PTZ API Error: ${response.status} ${response.statusText}`);
+      }
+
+      const data = await response.json();
+      this._log('PTZ API Response:', data);
+
+      // 触发成功事件
+      this._emit('request:success', { endpoint, params, data });
+
+      return data;
+    } catch (error) {
+      this._log('PTZ API Error:', error);
+      this._emit('request:error', { endpoint, params, error });
+      throw error;
+    }
+  }
+
+  /**
+   * PTZ方向控制
+   * @param {string} direction - 方向 ('up', 'down', 'left', 'right', 'stop')
+   * @param {number} [speed] - 速度 (1-100)
+   * @returns {Promise}
+   */
+  async move(direction, speed = this.currentSpeed) {
+    const command = direction === 'stop' ? 'stop' : direction;
+    const horizonSpeed = direction === 'left' || direction === 'right' ? 
+      Math.floor(speed * 255 / 100) : 0;
+    const verticalSpeed = direction === 'up' || direction === 'down' ? 
+      Math.floor(speed * 255 / 100) : 0;
+    const zoomSpeed = 0;
+
+    this.isMoving = command !== 'stop';
+
+    await this._request(`ptz/${this.config.deviceId}/${this.config.channelId}`, {
+      command,
+      horizonSpeed,
+      verticalSpeed,
+      zoomSpeed
+    });
+
+    this._emit('move', { direction, speed });
+    return this;
+  }
+
+  /**
+   * 停止所有PTZ动作
+   * @returns {Promise}
+   */
+  async stop() {
+    return this.move('stop', 0);
+  }
+
+  /**
+   * 变焦控制
+   * @param {string} direction - 'in' 或 'out'
+   * @param {number} [speed] - 速度 (1-100)
+   * @returns {Promise}
+   */
+  async zoom(direction, speed = this.currentSpeed) {
+    const command = direction === 'in' ? 'zoomin' : 'zoomout';
+    const zoomSpeed = Math.floor(speed * 16 / 100);
+
+    await this._request(`ptz/${this.config.deviceId}/${this.config.channelId}`, {
+      command,
+      horizonSpeed: 0,
+      verticalSpeed: 0,
+      zoomSpeed
+    });
+
+    this._emit('zoom', { direction, speed });
+    return this;
+  }
+
+  /**
+   * 聚焦控制
+   * @param {string} direction - 'near' 或 'far'
+   * @param {number} [speed] - 速度 (1-100)
+   * @returns {Promise}
+   */
+  async focus(direction, speed = this.currentSpeed) {
+    const focusSpeed = Math.floor(speed * 255 / 100);
+
+    await this._request(`fi/focus/${this.config.deviceId}/${this.config.channelId}`, {
+      command: direction,
+      speed: focusSpeed
+    });
+
+    this._emit('focus', { direction, speed });
+    return this;
+  }
+
+  /**
+   * 光圈控制
+   * @param {string} direction - 'in' 或 'out'
+   * @param {number} [speed] - 速度 (1-100)
+   * @returns {Promise}
+   */
+  async iris(direction, speed = this.currentSpeed) {
+    const irisSpeed = Math.floor(speed * 255 / 100);
+
+    await this._request(`fi/iris/${this.config.deviceId}/${this.config.channelId}`, {
+      command: direction,
+      speed: irisSpeed
+    });
+
+    this._emit('iris', { direction, speed });
+    return this;
+  }
+
+  /**
+   * 设置控制速度
+   * @param {number} speed - 速度 (1-100)
+   * @returns {PTZController}
+   */
+  setSpeed(speed) {
+    this.currentSpeed = Math.max(1, Math.min(100, speed));
+    this._emit('speed:change', { speed: this.currentSpeed });
+    return this;
+  }
+
+  /**
+   * 获取当前速度
+   * @returns {number}
+   */
+  getSpeed() {
+    return this.currentSpeed;
+  }
+
+  /**
+   * 事件监听
+   * @param {string} event - 事件名
+   * @param {Function} handler - 事件处理函数
+   * @returns {PTZController}
+   */
+  on(event, handler) {
+    if (!this.eventHandlers[event]) {
+      this.eventHandlers[event] = [];
+    }
+    this.eventHandlers[event].push(handler);
+    return this;
+  }
+
+  /**
+   * 移除事件监听
+   * @param {string} event - 事件名
+   * @param {Function} [handler] - 事件处理函数
+   * @returns {PTZController}
+   */
+  off(event, handler) {
+    if (!this.eventHandlers[event]) return this;
+    
+    if (handler) {
+      const index = this.eventHandlers[event].indexOf(handler);
+      if (index > -1) {
+        this.eventHandlers[event].splice(index, 1);
+      }
+    } else {
+      delete this.eventHandlers[event];
+    }
+    return this;
+  }
+
+  /**
+   * 触发事件
+   * @private
+   * @param {string} event - 事件名
+   * @param {*} data - 事件数据
+   */
+  _emit(event, data) {
+    if (this.eventHandlers[event]) {
+      this.eventHandlers[event].forEach(handler => {
+        try {
+          handler(data);
+        } catch (error) {
+          this._log('Event handler error:', error);
+        }
+      });
+    }
+  }
+
+  /**
+   * 调试日志
+   * @private
+   */
+  _log(...args) {
+    if (this.config.debug) {
+      console.log('[PTZController]', ...args);
+    }
+  }
+
+  /**
+   * 销毁控制器
+   */
+  destroy() {
+    this.eventHandlers = {};
+    this._log('PTZ Controller destroyed');
+  }
+}
+
+/**
+ * PTZ预置点管理器
+ */
+class PTZPresetManager {
+  constructor(controller) {
+    this.controller = controller;
+  }
+
+  /**
+   * 查询预置点列表
+   * @returns {Promise<Array>}
+   */
+  async list() {
+    const response = await this.controller._request(
+      `preset/query/${this.controller.config.deviceId}/${this.controller.config.channelId}`
+    );
+    this.controller._emit('preset:list', response);
+    return response;
+  }
+
+  /**
+   * 保存当前位置为预置点
+   * @param {number} presetId - 预置点ID (1-255)
+   * @returns {Promise}
+   */
+  async save(presetId) {
+    await this.controller._request(
+      `preset/add/${this.controller.config.deviceId}/${this.controller.config.channelId}`,
+      { presetId }
+    );
+    this.controller._emit('preset:saved', { presetId });
+    return this;
+  }
+
+  /**
+   * 调用预置点
+   * @param {number} presetId - 预置点ID
+   * @returns {Promise}
+   */
+  async call(presetId) {
+    await this.controller._request(
+      `preset/call/${this.controller.config.deviceId}/${this.controller.config.channelId}`,
+      { presetId }
+    );
+    this.controller._emit('preset:called', { presetId });
+    return this;
+  }
+
+  /**
+   * 删除预置点
+   * @param {number} presetId - 预置点ID
+   * @returns {Promise}
+   */
+  async delete(presetId) {
+    await this.controller._request(
+      `preset/delete/${this.controller.config.deviceId}/${this.controller.config.channelId}`,
+      { presetId }
+    );
+    this.controller._emit('preset:deleted', { presetId });
+    return this;
+  }
+}
+
+/**
+ * PTZ巡航管理器
+ */
+class PTZCruiseManager {
+  constructor(controller) {
+    this.controller = controller;
+  }
+
+  /**
+   * 开始巡航
+   * @param {number} cruiseId - 巡航组ID
+   * @returns {Promise}
+   */
+  async start(cruiseId = 1) {
+    await this.controller._request(
+      `cruise/start/${this.controller.config.deviceId}/${this.controller.config.channelId}`,
+      { cruiseId }
+    );
+    this.controller._emit('cruise:started', { cruiseId });
+    return this;
+  }
+
+  /**
+   * 停止巡航
+   * @param {number} cruiseId - 巡航组ID
+   * @returns {Promise}
+   */
+  async stop(cruiseId = 1) {
+    await this.controller._request(
+      `cruise/stop/${this.controller.config.deviceId}/${this.controller.config.channelId}`,
+      { cruiseId }
+    );
+    this.controller._emit('cruise:stopped', { cruiseId });
+    return this;
+  }
+
+  /**
+   * 设置巡航速度
+   * @param {number} cruiseId - 巡航组ID
+   * @param {number} speed - 巡航速度
+   * @returns {Promise}
+   */
+  async setSpeed(cruiseId, speed) {
+    await this.controller._request(
+      `cruise/speed/${this.controller.config.deviceId}/${this.controller.config.channelId}`,
+      { cruiseId, speed }
+    );
+    this.controller._emit('cruise:speed:set', { cruiseId, speed });
+    return this;
+  }
+}
+
+/**
+ * PTZ扫描管理器
+ */
+class PTZScanManager {
+  constructor(controller) {
+    this.controller = controller;
+  }
+
+  /**
+   * 开始扫描
+   * @param {number} scanId - 扫描组ID
+   * @returns {Promise}
+   */
+  async start(scanId = 1) {
+    await this.controller._request(
+      `scan/start/${this.controller.config.deviceId}/${this.controller.config.channelId}`,
+      { scanId }
+    );
+    this.controller._emit('scan:started', { scanId });
+    return this;
+  }
+
+  /**
+   * 停止扫描
+   * @param {number} scanId - 扫描组ID
+   * @returns {Promise}
+   */
+  async stop(scanId = 1) {
+    await this.controller._request(
+      `scan/stop/${this.controller.config.deviceId}/${this.controller.config.channelId}`,
+      { scanId }
+    );
+    this.controller._emit('scan:stopped', { scanId });
+    return this;
+  }
+
+  /**
+   * 设置扫描左边界
+   * @param {number} scanId - 扫描组ID
+   * @returns {Promise}
+   */
+  async setLeftBoundary(scanId = 1) {
+    await this.controller._request(
+      `scan/set/left/${this.controller.config.deviceId}/${this.controller.config.channelId}`,
+      { scanId }
+    );
+    this.controller._emit('scan:boundary:left', { scanId });
+    return this;
+  }
+
+  /**
+   * 设置扫描右边界
+   * @param {number} scanId - 扫描组ID
+   * @returns {Promise}
+   */
+  async setRightBoundary(scanId = 1) {
+    await this.controller._request(
+      `scan/set/right/${this.controller.config.deviceId}/${this.controller.config.channelId}`,
+      { scanId }
+    );
+    this.controller._emit('scan:boundary:right', { scanId });
+    return this;
+  }
+}
+
+export default PTZController;