使用场景
在以下两种场景下可以使用媒体扩展信息：
- 借用媒体链路传递时间戳，用于自己计算端到端网络延迟，或者跟自身其他业务做数据同步。
- 传递位控制信息，目前可以传递 8Byte 数据，共 64 位，每一位或者每几位数据可以表示一些控制信息，可以用于自身业务上的指令传输。
示例代码
以下代码均以时间戳为例。
- iOS
- 发送：
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)];)}
- 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); }
各个端使用注意点
因为复用音视频数据通道，必须控制自定义消息的发送频率和消息数据长度，使用限制如下：
- 为了不影响媒体数据的传输质量，自定义消息体长度限制为 8Byte，可以用来传输时间戳，位控制信息等。
- 每秒最多发送 30 条消息。
- repeatCount 为自定义消息冗余度，若大于 1，则会发送多次，防止网络丢包导致的消息丢失。
- 若 repeatCount 大于 1，房间里的其他人也会收到多次相同的消息，需要去重。
- 发送的自定义消息，在旁路直播时，房间里的订阅者也一样会收到。
- 目前 H5 不支持发送和接收。
「视频云技术」你最值得关注的音视频技术公众号，每周推送来自阿里云一线的实践技术文章，在这里与音视频领域一流工程师交流切磋。
