wrplayer 1.0.0

package/core/VoiceIntercomController.js

@@ -0,0 +1,492 @@
+/**
+ * Voice Intercom Controller for WRPlayer SDK
+ * 语音对讲控制器 - 支持GB28181协议的音视频设备语音对讲功能
+ */
+
+class VoiceIntercomController {
+  constructor(config = {}) {
+    this.config = {
+      apiUrl: config.apiUrl || 'http://localhost:18080',
+      apiKey: config.apiKey || '',
+      debug: config.debug || false,
+      timeout: config.timeout || 30,
+      ...config
+    };
+
+    // 语音对讲状态
+    this.status = {
+      IDLE: -1,        // 空闲状态
+      CONNECTING: 0,   // 连接中
+      CONNECTED: 1,    // 已连接
+      RELEASING: -2    // 释放资源中
+    };
+
+    // 当前状态
+    this.currentStatus = this.status.IDLE;
+    
+    // 对讲模式
+    this.modes = {
+      BROADCAST: true,  // 喊话模式（单向）
+      TALK: false      // 对讲模式（双向）
+    };
+
+    // 当前模式
+    this.currentMode = this.modes.TALK;
+
+    // WebRTC客户端
+    this.rtcClient = null;
+    
+    // 当前设备信息
+    this.currentDevice = null;
+    this.currentChannel = null;
+
+    // 事件监听器
+    this.eventListeners = {};
+
+    // 绑定方法上下文
+    this._bindMethods();
+
+    if (this.config.debug) {
+      console.log('VoiceIntercomController initialized:', this.config);
+    }
+  }
+
+  /**
+   * 绑定方法上下文
+   */
+  _bindMethods() {
+    this.startIntercom = this.startIntercom.bind(this);
+    this.stopIntercom = this.stopIntercom.bind(this);
+    this.setMode = this.setMode.bind(this);
+    this.getStatus = this.getStatus.bind(this);
+    this._handleRTCEvents = this._handleRTCEvents.bind(this);
+  }
+
+  /**
+   * 开始语音对讲
+   * @param {string} deviceId - 设备ID
+   * @param {string} channelId - 通道ID  
+   * @param {boolean} mode - 对讲模式 (true: 喊话, false: 对讲)
+   * @returns {Promise<void>}
+   */
+  async startIntercom(deviceId, channelId, mode = this.currentMode) {
+    if (this.currentStatus !== this.status.IDLE) {
+      throw new Error('Voice intercom is already active or connecting');
+    }
+
+    try {
+      this.currentDevice = deviceId;
+      this.currentChannel = channelId;
+      this.currentMode = mode;
+      this.currentStatus = this.status.CONNECTING;
+
+      this._emit('statusChange', {
+        status: this.currentStatus,
+        statusText: '正在连接...',
+        mode: this.currentMode
+      });
+
+      // 调用开始对讲API
+      const response = await this._callAPI('GET', `play/broadcast/${deviceId}/${channelId}`, {
+        timeout: this.config.timeout,
+        broadcastMode: mode
+      });
+
+      if (response.code === 0) {
+        // 获取WebRTC流URL
+        const streamData = response.data;
+        await this._setupWebRTC(streamData);
+      } else {
+        throw new Error(response.msg || 'Failed to start voice intercom');
+      }
+
+    } catch (error) {
+      this.currentStatus = this.status.IDLE;
+      this._emit('error', {
+        type: 'start_failed',
+        message: error.message,
+        error
+      });
+      throw error;
+    }
+  }
+
+  /**
+   * 停止语音对讲
+   * @returns {Promise<void>}
+   */
+  async stopIntercom() {
+    if (this.currentStatus === this.status.IDLE) {
+      return;
+    }
+
+    try {
+      this.currentStatus = this.status.RELEASING;
+      this._emit('statusChange', {
+        status: this.currentStatus,
+        statusText: '正在释放资源...',
+        mode: this.currentMode
+      });
+
+      // 关闭WebRTC连接
+      if (this.rtcClient) {
+        this.rtcClient.close();
+        this.rtcClient = null;
+      }
+
+      // 调用停止对讲API
+      if (this.currentDevice && this.currentChannel) {
+        await this._callAPI('GET', `play/broadcast/stop/${this.currentDevice}/${this.currentChannel}`);
+      }
+
+      this.currentStatus = this.status.IDLE;
+      this.currentDevice = null;
+      this.currentChannel = null;
+
+      this._emit('statusChange', {
+        status: this.currentStatus,
+        statusText: '对讲已停止',
+        mode: this.currentMode
+      });
+
+    } catch (error) {
+      this.currentStatus = this.status.IDLE;
+      this._emit('error', {
+        type: 'stop_failed',
+        message: error.message,
+        error
+      });
+      throw error;
+    }
+  }
+
+  /**
+   * 设置对讲模式
+   * @param {boolean} mode - 对讲模式 (true: 喊话, false: 对讲)
+   */
+  setMode(mode) {
+    if (this.currentStatus !== this.status.IDLE) {
+      throw new Error('Cannot change mode while intercom is active');
+    }
+    this.currentMode = mode;
+    this._emit('modeChange', { mode });
+  }
+
+  /**
+   * 获取当前状态
+   * @returns {Object}
+   */
+  getStatus() {
+    return {
+      status: this.currentStatus,
+      mode: this.currentMode,
+      deviceId: this.currentDevice,
+      channelId: this.currentChannel,
+      isActive: this.currentStatus !== this.status.IDLE
+    };
+  }
+
+  /**
+   * 获取状态文本
+   * @returns {string}
+   */
+  getStatusText() {
+    switch (this.currentStatus) {
+      case this.status.IDLE:
+        return '点击开始对讲';
+      case this.status.CONNECTING:
+        return '等待接通中...';
+      case this.status.CONNECTED:
+        return '请说话';
+      case this.status.RELEASING:
+        return '正在释放资源';
+      default:
+        return '未知状态';
+    }
+  }
+
+  /**
+   * 获取模式文本
+   * @returns {string}
+   */
+  getModeText() {
+    return this.currentMode ? '喊话模式' : '对讲模式';
+  }
+
+  /**
+   * 设置WebRTC连接
+   * @param {Object} streamData - 流数据
+   */
+  async _setupWebRTC(streamData) {
+    if (typeof ZLMRTCClient === 'undefined') {
+      throw new Error('ZLMRTCClient library is not loaded');
+    }
+
+    try {
+      // 构建WebRTC连接URL
+      let rtcUrl = streamData.rtmp || streamData.flv || streamData.ws_flv;
+      if (!rtcUrl) {
+        throw new Error('No valid stream URL found');
+      }
+
+      // 添加认证签名
+      if (streamData.pushKey) {
+        const sign = await this._generateMD5Hash(streamData.pushKey);
+        rtcUrl += '&sign=' + sign;
+      }
+
+      // 创建WebRTC客户端
+      this.rtcClient = new ZLMRTCClient.Endpoint({
+        debug: this.config.debug,
+        zlmsdpUrl: rtcUrl,
+        simulecast: false,
+        useCamera: false,
+        audioEnable: true,
+        videoEnable: false,
+        recvOnly: false
+      });
+
+      // 设置事件监听
+      this._handleRTCEvents();
+
+      // 开始连接
+      await this.rtcClient.start();
+
+    } catch (error) {
+      this.currentStatus = this.status.IDLE;
+      throw error;
+    }
+  }
+
+  /**
+   * 处理WebRTC事件
+   */
+  _handleRTCEvents() {
+    if (!this.rtcClient) return;
+
+    // WebRTC不支持
+    this.rtcClient.on('WEBRTC_NOT_SUPPORT', (e) => {
+      this._emit('error', {
+        type: 'webrtc_not_support',
+        message: '浏览器不支持WebRTC，无法进行语音对讲',
+        error: e
+      });
+    });
+
+    // ICE协商错误
+    this.rtcClient.on('WEBRTC_ICE_CANDIDATE_ERROR', (e) => {
+      this._emit('error', {
+        type: 'ice_error',
+        message: 'ICE协商出错',
+        error: e
+      });
+    });
+
+    // 连接状态变化
+    this.rtcClient.on('WEBRTC_ON_CONNECTION_STATE_CHANGE', (state) => {
+      if (state === 'connecting') {
+        this.currentStatus = this.status.CONNECTING;
+      } else if (state === 'connected') {
+        this.currentStatus = this.status.CONNECTED;
+      } else if (state === 'disconnected') {
+        this.currentStatus = this.status.IDLE;
+      }
+
+      this._emit('statusChange', {
+        status: this.currentStatus,
+        statusText: this.getStatusText(),
+        mode: this.currentMode,
+        connectionState: state
+      });
+    });
+
+    // 媒体流事件
+    this.rtcClient.on('WEBRTC_ON_LOCAL_STREAM', (stream) => {
+      this._emit('localStream', { stream });
+    });
+
+    this.rtcClient.on('WEBRTC_ON_REMOTE_STREAM', (stream) => {
+      this._emit('remoteStream', { stream });
+    });
+  }
+
+  /**
+   * 调用API
+   * @param {string} method - HTTP方法
+   * @param {string} endpoint - API端点
+   * @param {Object} params - 请求参数
+   * @returns {Promise<Object>}
+   */
+  async _callAPI(method, endpoint, params = {}) {
+    // 构建完整URL
+    let fullUrl;
+    try {
+      // 如果apiUrl是相对路径（代理模式），直接拼接
+      if (this.config.apiUrl.startsWith('/')) {
+        // 移除endpoint开头的斜杠避免双斜杠
+        const cleanEndpoint = endpoint.startsWith('/') ? endpoint.slice(1) : endpoint;
+        fullUrl = `${this.config.apiUrl}/${cleanEndpoint}`;
+      } else {
+        // 绝对URL，使用URL构造函数
+        fullUrl = new URL(endpoint, this.config.apiUrl).toString();
+      }
+    } catch (error) {
+      // 回退方案：直接拼接
+      const baseUrl = this.config.apiUrl.endsWith('/') ? this.config.apiUrl.slice(0, -1) : this.config.apiUrl;
+      const cleanEndpoint = endpoint.startsWith('/') ? endpoint : `/${endpoint}`;
+      fullUrl = `${baseUrl}${cleanEndpoint}`;
+    }
+
+    // 构建URL对象以添加查询参数
+    const url = new URL(fullUrl, window.location.origin);
+    
+    // 添加查询参数
+    if (method === 'GET' && params) {
+      Object.keys(params).forEach(key => {
+        if (params[key] !== undefined && params[key] !== null) {
+          url.searchParams.append(key, params[key]);
+        }
+      });
+    }
+
+    const options = {
+      method,
+      headers: {
+        'Content-Type': 'application/json'
+      }
+    };
+
+    // 添加API Key认证
+    if (this.config.apiKey) {
+      options.headers['api-key'] = this.config.apiKey;
+    }
+
+    // 添加请求体
+    if (method !== 'GET' && params) {
+      options.body = JSON.stringify(params);
+    }
+
+    const response = await fetch(url.toString(), options);
+    
+    if (!response.ok) {
+      throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+    }
+
+    return await response.json();
+  }
+
+  /**
+   * 触发事件
+   * @param {string} eventName - 事件名称
+   * @param {Object} data - 事件数据
+   */
+  _emit(eventName, data) {
+    if (this.eventListeners[eventName]) {
+      this.eventListeners[eventName].forEach(callback => {
+        try {
+          callback(data);
+        } catch (error) {
+          console.error(`Error in ${eventName} event listener:`, error);
+        }
+      });
+    }
+
+    if (this.config.debug) {
+      console.log(`VoiceIntercom Event [${eventName}]:`, data);
+    }
+  }
+
+  /**
+   * 添加事件监听器
+   * @param {string} eventName - 事件名称
+   * @param {Function} callback - 回调函数
+   */
+  on(eventName, callback) {
+    if (!this.eventListeners[eventName]) {
+      this.eventListeners[eventName] = [];
+    }
+    this.eventListeners[eventName].push(callback);
+  }
+
+  /**
+   * 移除事件监听器
+   * @param {string} eventName - 事件名称
+   * @param {Function} callback - 回调函数
+   */
+  off(eventName, callback) {
+    if (this.eventListeners[eventName]) {
+      const index = this.eventListeners[eventName].indexOf(callback);
+      if (index > -1) {
+        this.eventListeners[eventName].splice(index, 1);
+      }
+    }
+  }
+
+  /**
+   * 生成MD5哈希值 (浏览器环境兼容)
+   * @param {string} text - 要哈希的文本
+   * @returns {Promise<string>} MD5哈希值
+   * @private
+   */
+  async _generateMD5Hash(text) {
+    // 如果在Node.js环境中，使用crypto模块
+    if (typeof require !== 'undefined' && typeof window === 'undefined') {
+      const crypto = require('crypto');
+      return crypto.createHash('md5').update(text, 'utf8').digest('hex');
+    }
+
+    // 浏览器环境：使用Web Crypto API的简化MD5实现
+    // 注意：Web Crypto API不支持MD5，这里使用简单的替代方案
+    // 在生产环境中，建议服务器端生成签名
+    if (typeof crypto !== 'undefined' && crypto.subtle) {
+      const encoder = new TextEncoder();
+      const data = encoder.encode(text);
+      const hashBuffer = await crypto.subtle.digest('SHA-256', data);
+      const hashArray = Array.from(new Uint8Array(hashBuffer));
+      return hashArray.map(b => b.toString(16).padStart(2, '0')).join('').substring(0, 32);
+    }
+
+    // 回退方案：简单哈希函数（仅用于演示）
+    let hash = 0;
+    for (let i = 0; i < text.length; i++) {
+      const char = text.charCodeAt(i);
+      hash = ((hash << 5) - hash) + char;
+      hash = hash & hash; // 转换为32位整数
+    }
+    return Math.abs(hash).toString(16).padStart(32, '0').substring(0, 32);
+  }
+
+  /**
+   * 销毁控制器
+   */
+  destroy() {
+    // 停止对讲
+    if (this.currentStatus !== this.status.IDLE) {
+      this.stopIntercom().catch(console.error);
+    }
+
+    // 清理事件监听器
+    this.eventListeners = {};
+
+    // 清理WebRTC客户端
+    if (this.rtcClient) {
+      this.rtcClient.close();
+      this.rtcClient = null;
+    }
+
+    if (this.config.debug) {
+      console.log('VoiceIntercomController destroyed');
+    }
+  }
+}
+
+// 兼容不同模块系统
+if (typeof module !== 'undefined' && typeof module.exports !== 'undefined') {
+  module.exports = VoiceIntercomController;
+} else if (typeof define === 'function' && define.amd) {
+  define([], function() { return VoiceIntercomController; });
+} else if (typeof window !== 'undefined') {
+  window.VoiceIntercomController = VoiceIntercomController;
+}
+
+export default VoiceIntercomController;