mirror of
https://github.com/mollyim/webrtc.git
synced 2025-05-16 07:10:38 +01:00
f8e7ccb967
Create a new RTCP feedback message for reporting the loss and/or non-decodability of video frames, to be used by the upcoming injectable VideoFrameBufferController. The new feedback message should report: 1. The sequence number of the last decoded non-discardable video frame. (TBD: If a multi-packet frame, should it be the sequence number of the first, last, or any of the packets?) 2. The sequence number of the last received RTP packet in the stream. 3. A decodability flag, whose specific meaning depends on the last-received RTP sequence number. The decodability flag is true if and only if all of the frame's dependencies are known to be decodable, and the frame itself is not yet known to be unassemblable. * Clarification #1: In a multi-packet frame, the first packet's dependencies are known, but it is not yet known whether all parts of the current frame will be received. * Clarification #2: In a multi-packet frame, the dependencies would be unknown if the first packet was not received. Then, the packet will be known-unassemblable. Bug: webrtc:10226 Change-Id: I1563c944477e3ed40235e82ab99a439414632aff Reviewed-on: https://webrtc-review.googlesource.com/c/118931 Commit-Queue: Elad Alon <eladalon@webrtc.org> Reviewed-by: Danil Chapovalov <danilchap@webrtc.org> Reviewed-by: Björn Terelius <terelius@webrtc.org> Cr-Commit-Position: refs/heads/master@{#26387}
79 lines
3.1 KiB
C++
79 lines
3.1 KiB
C++
/*
|
|
* Copyright (c) 2019 The WebRTC project authors. All Rights Reserved.
|
|
*
|
|
* Use of this source code is governed by a BSD-style license
|
|
* that can be found in the LICENSE file in the root of the source
|
|
* tree. An additional intellectual property rights grant can be found
|
|
* in the file PATENTS. All contributing project authors may
|
|
* be found in the AUTHORS file in the root of the source tree.
|
|
*/
|
|
|
|
#ifndef MODULES_RTP_RTCP_SOURCE_RTCP_PACKET_LOSS_NOTIFICATION_H_
|
|
#define MODULES_RTP_RTCP_SOURCE_RTCP_PACKET_LOSS_NOTIFICATION_H_
|
|
|
|
#include "modules/rtp_rtcp/source/rtcp_packet/common_header.h"
|
|
#include "modules/rtp_rtcp/source/rtcp_packet/psfb.h"
|
|
#include "rtc_base/system/unused.h"
|
|
|
|
namespace webrtc {
|
|
namespace rtcp {
|
|
|
|
class LossNotification : public Psfb {
|
|
public:
|
|
static constexpr uint8_t kFeedbackMessageType = 15;
|
|
|
|
LossNotification();
|
|
LossNotification(const LossNotification& other);
|
|
~LossNotification() override;
|
|
|
|
size_t BlockLength() const override;
|
|
|
|
bool Create(uint8_t* packet,
|
|
size_t* index,
|
|
size_t max_length,
|
|
PacketReadyCallback callback) const override
|
|
RTC_WARN_UNUSED_RESULT;
|
|
|
|
// Parse assumes header is already parsed and validated.
|
|
bool Parse(const CommonHeader& packet) RTC_WARN_UNUSED_RESULT;
|
|
|
|
// Set all of the values transmitted by the loss notification message.
|
|
// If the values may not be represented by a loss notification message,
|
|
// false is returned, and no change is made to the object; this happens
|
|
// when |last_recieved| is ahead of |last_decoded| by more than 0x7fff.
|
|
// This is because |last_recieved| is represented on the wire as a delta,
|
|
// and only 15 bits are available for that delta.
|
|
bool Set(uint16_t last_decoded,
|
|
uint16_t last_received,
|
|
bool decodability_flag) RTC_WARN_UNUSED_RESULT;
|
|
|
|
// RTP sequence number of the first packet belong to the last decoded
|
|
// non-discardable frame.
|
|
uint16_t last_decoded() const { return last_decoded_; }
|
|
|
|
// RTP sequence number of the last received packet.
|
|
uint16_t last_received() const { return last_received_; }
|
|
|
|
// A decodability flag, whose specific meaning depends on the last-received
|
|
// RTP sequence number. The decodability flag is true if and only if all of
|
|
// the frame's dependencies are known to be decodable, and the frame itself
|
|
// is not yet known to be unassemblable.
|
|
// * Clarification #1: In a multi-packet frame, the first packet's
|
|
// dependencies are known, but it is not yet known whether all parts
|
|
// of the current frame will be received.
|
|
// * Clarification #2: In a multi-packet frame, the dependencies would be
|
|
// unknown if the first packet was not received. Then, the packet will
|
|
// be known-unassemblable.
|
|
bool decodability_flag() const { return decodability_flag_; }
|
|
|
|
private:
|
|
static constexpr uint32_t kUniqueIdentifier = 0x4C4E5446; // 'L' 'N' 'T' 'F'.
|
|
static constexpr size_t kLossNotificationPayloadLength = 8;
|
|
|
|
uint16_t last_decoded_;
|
|
uint16_t last_received_;
|
|
bool decodability_flag_;
|
|
};
|
|
} // namespace rtcp
|
|
} // namespace webrtc
|
|
#endif // MODULES_RTP_RTCP_SOURCE_RTCP_PACKET_LOSS_NOTIFICATION_H_
|