产品百科 |RTC SDK 媒体扩展信息的使用说明-阿里云开发者社区

开发者社区> 阿里云视频云> 正文
登录阅读全文

产品百科 |RTC SDK 媒体扩展信息的使用说明

简介: 本文为您介绍媒体扩展信息的使用说明,您可以使用传递时间戳和位控制信息,以达到更好的产品体验。

使用场景

在以下两种场景下可以使用媒体扩展信息:

  • 借用媒体链路传递时间戳,用于自己计算端到端网络延迟,或者跟自身其他业务做数据同步。
  • 传递位控制信息,目前可以传递 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 不支持发送和接收。


「视频云技术」你最值得关注的音视频技术公众号,每周推送来自阿里云一线的实践技术文章,在这里与音视频领域一流工程师交流切磋。

image.png

版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。

分享:

分享视频云行业和技术趋势,打造“新内容”、“新交互”。

官方博客
官网链接