GetChannelData

订阅指定实盘的频道数据。该函数用于实盘间通信，可获取其他实盘通过SetChannelData()函数发布的最新状态数据。

    
    
    
GetChannelData(channelId)

示例

• 频道订阅端示例 - 订阅两个实盘的频道数据

  • javascript
  • python
  • rust
  • cpp

  
      javascript
      
      
  function main() {
      // 需要订阅的两个频道 ID（请根据实际情况修改）
      var channelId1 = "632799"  // 频道 1 的实盘 ID
      var channelId2 = "632800"  // 频道 2 的实盘 ID
  
      while(true) {
          // 订阅频道 1 的当前状态
          var state1 = GetChannelData(channelId1)
  
          // 订阅频道 2 的当前状态
          var state2 = GetChannelData(channelId2)
  
          // 构建状态显示
          var statusMsg = "频道订阅端 - 当前订阅状态\n\n"
  
          // 显示频道 1 状态
          statusMsg += "═══ 频道1 [" + channelId1 + "] ═══\n"
          if (state1 !== null) {
              statusMsg += "更新ID: #" + state1.updateId + "\n"
              statusMsg += "时间: " + _D(state1.timestamp) + "\n"
              statusMsg += "交易对: " + state1.symbol + "\n"
              statusMsg += "最新价: $" + state1.lastPrice.toFixed(2) + "\n"
              statusMsg += "成交量: " + state1.volume.toFixed(4) + "\n"
          } else {
              statusMsg += "状态: 等待中... (首次调用返回 null)\n"
          }
  
          statusMsg += "\n"
  
          // 显示频道 2 状态
          statusMsg += "═══ 频道2 [" + channelId2 + "] ═══\n"
          if (state2 !== null) {
              statusMsg += "更新ID: #" + state2.updateId + "\n"
              statusMsg += "时间: " + _D(state2.timestamp) + "\n"
              statusMsg += "交易对: " + state2.symbol + "\n"
              statusMsg += "最新价: $" + state2.lastPrice.toFixed(2) + "\n"
              statusMsg += "成交量: " + state2.volume.toFixed(4) + "\n"
          } else {
              statusMsg += "状态: 等待中... (首次调用返回 null)\n"
          }
  
          LogStatus(statusMsg)
  
          Sleep(5000)  // 每 5 秒订阅一次频道
      }
  }
  

  
      python
      
      
  def main():
      # 需要订阅的两个频道 ID（请根据实际情况修改）
      channelId1 = "632799"  # 频道 1 的实盘 ID
      channelId2 = "632800"  # 频道 2 的实盘 ID
  
      while True:
          # 订阅频道 1 的当前状态
          state1 = GetChannelData(channelId1)
  
          # 订阅频道 2 的当前状态
          state2 = GetChannelData(channelId2)
  
          # 构建状态显示
          statusMsg = "频道订阅端 - 当前订阅状态\n\n"
  
          # 显示频道 1 状态
          statusMsg += "═══ 频道1 [{}] ═══\n".format(channelId1)
          if state1 is not None:
              statusMsg += "更新ID: #{}\n".format(state1["updateId"])
              statusMsg += "时间: {}\n".format(_D(state1["timestamp"]))
              statusMsg += "交易对: {}\n".format(state1["symbol"])
              statusMsg += "最新价: ${:.2f}\n".format(state1["lastPrice"])
              statusMsg += "成交量: {:.4f}\n".format(state1["volume"])
          else:
              statusMsg += "状态: 等待中... (首次调用返回 None)\n"
  
          statusMsg += "\n"
  
          # 显示频道 2 状态
          statusMsg += "═══ 频道2 [{}] ═══\n".format(channelId2)
          if state2 is not None:
              statusMsg += "更新ID: #{}\n".format(state2["updateId"])
              statusMsg += "时间: {}\n".format(_D(state2["timestamp"]))
              statusMsg += "交易对: {}\n".format(state2["symbol"])
              statusMsg += "最新价: ${:.2f}\n".format(state2["lastPrice"])
              statusMsg += "成交量: {:.4f}\n".format(state2["volume"])
          else:
              statusMsg += "状态: 等待中... (首次调用返回 None)\n"
  
          LogStatus(statusMsg)
  
          Sleep(5000)  # 每 5 秒订阅一次频道
  

  
      rust
      
      
  fn main() {
      // Rust 的 GetChannelData() 函数不接受频道 ID 参数，只能读取当前实盘自身频道
      // （即本实盘通过 SetChannelData() 发布）的最新数据，无法订阅其它实盘的频道
      loop {
          // 订阅频道的当前状态
          let state = GetChannelData();
  
          // 构建状态显示
          let mut statusMsg = String::from("频道订阅端 - 当前订阅状态\n\n");
  
          if !state.is_null() {
              statusMsg += &format!("更新ID: #{}\n", state["updateId"].as_i64().unwrap_or(0));
              statusMsg += &format!("时间: {}\n", _D(state["timestamp"].as_i64().unwrap_or(0)));
              statusMsg += &format!("交易对: {}\n", state["symbol"].as_str().unwrap_or(""));
              statusMsg += &format!("最新价: ${:.2}\n", state["lastPrice"].as_f64().unwrap_or(0.0));
              statusMsg += &format!("成交量: {:.4}\n", state["volume"].as_f64().unwrap_or(0.0));
          } else {
              statusMsg += "状态: 等待中... (首次调用返回 null)\n";
          }
  
          LogStatus!(statusMsg);
  
          Sleep(5000);  // 每 5 秒订阅一次频道
      }
  }
  

  
      c++
      
      
  

• 跨平台订阅示例 - 使用 UUID 订阅外部系统发送的数据

  • javascript
  • python
  • rust
  • cpp

  
      javascript
      
      
  function main() {
      // 使用 32 位 UUID 作为频道标识符
      let uuid = "6BC42A119B5DBFA2188A8279DA3B5C30"
  
      while (true) {
          // 订阅 UUID 频道的数据
          let data = GetChannelData(uuid)
  
          if (data !== null) {
              Log("Received cross-platform data:", data)
          } else {
              Log("Waiting for data... (first call returns null)")
          }
  
          Sleep(10000)  // 每 10 秒检查一次
      }
  }
  

  
      python
      
      
  def main():
      # 使用 32 位 UUID 作为频道标识符
      uuid = "6BC42A119B5DBFA2188A8279DA3B5C30"
  
      while True:
          # 订阅 UUID 频道的数据
          data = GetChannelData(uuid)
  
          if data is not None:
              Log("Received cross-platform data:", data)
          else:
              Log("Waiting for data... (first call returns None)")
  
          Sleep(10000)  # 每 10 秒检查一次
  

  
      rust
      
      
  fn main() {
      // Rust 的 GetChannelData() 函数不接受频道 ID 参数，无法使用 32 位 UUID 订阅跨平台数据，
      // 只能读取当前实盘自身频道（即本实盘通过 SetChannelData() 发布）的最新数据
      loop {
          // 订阅频道的数据
          let data = GetChannelData();
  
          if !data.is_null() {
              Log!("Received cross-platform data:", data);
          } else {
              Log!("Waiting for data... (first call returns null)");
          }
  
          Sleep(10000);  // 每 10 秒检查一次
      }
  }
  

  
      c++
      
      
  

返回值

参数

参考

备注

GetChannelData()函数为非阻塞调用，调用后立即返回，不会等待数据接收完成。

首次调用GetChannelData()函数时会返回null，需要重试并等待频道数据同步完成。

每次调用获取的均为频道上的最新状态数据，而非历史消息队列。

一个实盘可同时订阅多个不同实盘的频道，只需多次调用GetChannelData()并分别传入不同的实盘ID即可。

当前实盘也可以订阅自身的频道，即robotId参数可以是当前实盘的ID。

频道数据可跨实盘、跨托管者、跨服务器进行传输。

广播端使用SetChannelData()函数发布频道数据。

频道通信适用于实盘环境，在回测系统中该功能可能受限。

GetChannelData()函数支持跨平台订阅功能。当使用32位UUID作为频道标识符时，可接收来自FMZ平台外部系统通过HTTP API发送的数据。外部系统需同时指定实盘ID和UUID才能发送数据；同一托管者下的所有实盘均可订阅该UUID频道的数据，而不同托管者的实盘则无法订阅。