RTC SDK提供了发送和接收媒体扩展信息的功能。通过阅读本文,您可以了解到媒体扩展信息的使用方法。

使用场景

  • 您可以使用媒体扩展信息传递时间戳,计算端到端的网络延迟,或者跟自身其他业务做数据同步。
  • 您可以使用媒体扩展信息传递位控制信息。目前可以传递8 Byte数据,即64位,每一位或几位可以表示控制信息,用于自身业务上的指令传输。

示例代码

以下代码均以使用媒体扩展信息传递时间戳为例进行介绍。

  • iOS和Mac
    • 发送端:
      NSTimeInterval now = [[NSDate dateWithTimeIntervalSinceNow:0] timeIntervalSince1970];
      long long lNow = CFSwapInt64BigToHost((long long)(now * 1000));
      NSData * timeData = [NSData dataWithBytes:&lNow length:sizeof(lNow)];
      [self.engine sendMediaExtensionMsg:timeData repeatCount:5];
    • 接收端:
      - (void)onMediaExtensionMsgReceived:(NSString *)uid message:(NSData *)data {
          long long receivedLongLongValue = 0;
          [data getBytes:&receivedLongLongValue length:8];
          long long sentTime = CFSwapInt64BigToHost(receivedLongLongValue);
          NSTimeInterval now = [[NSDate dateWithTimeIntervalSinceNow:0] timeIntervalSince1970];
          long long nowTime = (long long)(now * 1000);
          NSLog(@"%@", [NSString stringWithFormat:@"uid: %@, now: %lld, sent: %lld, 差值: %lld", uid, nowTime, sentTime, (nowTime-sentTime)];)}
  • Android
    • 发送端:
      long lNow = System.currentTimeMillis();
      byte b[] = new byte[8];
      ByteBuffer buf = ByteBuffer.wrap(b);
      buf.putLong(l);
      buf.flip();
      mAliRtcEngine.sendMediaExtensionMsg(buf.array(), 5);
    • 接收端:
      public void onMediaExtensionMsgReceived(String uid, byte[] message) {
          super.onMediaExtensionMsgReceived(uid, message);
          ByteBuffer buffer = ByteBuffer.allocate(8);
          buffer.put(message, 0, message.length);
          buffer.flip();
          long sentTime = buffer.getLong();
      }
  • Windows
    • 发送端:
      char* long2charArr(long long num)
      {
          char* arr = new char[8];
          int x = 56;
          for (int i = 7; i >= 0; i--)
          {
              long long temp = num << x;
              arr[i] = temp >> 56;
              x -= 8;
          }
          return arr;
      }
      
      SYSTEMTIME tmSys;
      GetLocalTime(&tmSys);
      CTime ctmNow(tmSys);
      long long lNow = __int64(ctmNow.GetTime()) * 1000 + tmSys.wMilliseconds;
      char* cNow = long2charArr(lNow);
      mpEngine->sendMediaExtensionMsg((unsigned char*)cNow, 8, 5);
      delete cNow;
    • 接收端:
      long long charArr2long(char* p)
      {
          long long value = 0;
          value = (((long long)p[0] << 56 & 0xFF00000000000000L) |
          ((long long)p[1] << 48 & 0xFF000000000000L) |
          ((long long)p[2] << 40 & 0xFF0000000000L) |
          ((long long)p[3] << 32 & 0xFF00000000L) |
          ((long long)p[4] << 24 & 0xFF000000L) |
          ((long long)p[5] << 16 & 0xFF0000L) |
          ((long long)p[6] << 8 & 0xFF00L) |
          ((long long)p[7] & 0xFFL));
          return value;
      }
      
      void CTutorialDlg::onMediaExtensionMsgReceived(const AliRtc::String &uid, unsigned char* message, int size)
      {
          long long sentTime = charArr2long((char*)message);
      }

注意事项

使用媒体扩展信息时需要复用音视频数据通道,因此必须控制自定义消息的发送频率和消息数据长度,使用限制如下:
  • 为了不影响媒体数据的传输质量,自定义消息体长度限制为8 Byte,可以用来传输时间戳,位控制信息等。
  • 每秒最多发送30条消息。
  • sendMediaExtensionMsg函数中repeatCount参数为自定义消息冗余度,若大于1,则会发送多次,防止网络丢包导致的消息丢失,此时房间里的其他人也会收到多次相同的消息,需要去重。
  • 发送的自定义消息,在旁路直播时,房间里的订阅者也一样会收到。
  • 目前H5端不支持发送和接收媒体扩展信息。