RtcpContext.h

/*
 * Copyright (c) 2016 The ZLMediaKit project authors. All Rights Reserved.
 *
 * This file is part of ZLMediaKit(https://github.com/xia-chu/ZLMediaKit).
 *
 * Use of this source code is governed by MIT license that can be found in the
 * LICENSE file in the root of the source tree. All contributing project authors
 * may be found in the AUTHORS file in the root of the source tree.
 */

#ifndef ZLMEDIAKIT_RTCPCONTEXT_H
#define ZLMEDIAKIT_RTCPCONTEXT_H

#include <stdint.h>
#include <stddef.h>
#include "Rtcp.h"

namespace mediakit {

class RtcpContext {
public:
    using Ptr = std::shared_ptr<RtcpContext>;
    /**
     * 创建rtcp上下文
     * @param sample_rate 音频采用率，视频一般为90000
     * @param is_receiver 是否为rtp接收者，接收者更消耗性能
     */
    RtcpContext(uint32_t sample_rate, bool is_receiver);

    /**
     * 输出或输入rtp时调用
     * @param seq rtp的seq
     * @param stamp rtp的时间戳，单位毫秒
     * @param bytes rtp数据长度
     */
    void onRtp(uint16_t seq, uint32_t stamp, size_t bytes);

    /**
     * 输入sr rtcp包
     * @param rtcp 输入一个rtcp
     */
    void onRtcp(RtcpHeader *rtcp);

    /**
     * 计算总丢包数
     */
    size_t getLost();

    /**
     * 返回理应收到的rtp数
     */
    size_t getExpectedPackets() const;

    /**
     * 创建SR rtcp包
     * @param rtcp_ssrc rtcp的ssrc
     * @return rtcp包
     */
    Buffer::Ptr createRtcpSR(uint32_t rtcp_ssrc);

    /**
     * 创建RR rtcp包
     * @param rtcp_ssrc rtcp的ssrc
     * @param rtp_ssrc rtp的ssrc
     * @return rtcp包
     */
    Buffer::Ptr createRtcpRR(uint32_t rtcp_ssrc, uint32_t rtp_ssrc);

    /**
     * 清空状态
     */
    void clear();

private:
    /**
     * 上次结果与本次结果间应收包数
     */
    size_t getExpectedPacketsInterval();

    /**
     * 上次结果与本次结果间丢包个数
     */
    size_t geLostInterval();

private:
    //是否为接收者
    bool _is_receiver;
    //时间戳抖动值
    double _jitter = 0;
    //视频默认90000,音频为采样率
    uint32_t _sample_rate;
    //收到或发送的rtp的字节数
    size_t _bytes = 0;
    //收到或发送的rtp的个数
    size_t _packets = 0;
    //第一个seq的值
    uint16_t _seq_base = 0;
    //rtp最大seq
    uint16_t _seq_max = 0;
    //rtp回环次数
    uint16_t _seq_cycles = 0;
    //上次回环发生时，记录的rtp包数
    size_t _last_cycle_packets = 0;
    //上次的seq
    uint16_t _last_rtp_seq = 0;
    //上次的rtp时间戳,毫秒
    uint32_t _last_rtp_stamp = 0;
    //上次的rtp的系统时间戳(毫秒)用于统计抖动
    uint64_t _last_rtp_sys_stamp = 0;
    //上次统计的丢包总数
    size_t _last_lost = 0;
    //上次统计应收rtp包总数
    size_t _last_expected = 0;
    //上次收到sr包时计算出的Last SR timestamp
    uint32_t _last_sr_lsr = 0;
    //上次收到sr时的系统时间戳,单位毫秒
    uint64_t _last_sr_ntp_sys = 0;
};

}//namespace mediakit
#endif //ZLMEDIAKIT_RTCPCONTEXT_H