henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 1 | /* |
kjellander | 1afca73 | 2016-02-07 20:46:45 -0800 | [diff] [blame] | 2 | * Copyright (c) 2011 The WebRTC project authors. All Rights Reserved. |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 3 | * |
kjellander | 1afca73 | 2016-02-07 20:46:45 -0800 | [diff] [blame] | 4 | * Use of this source code is governed by a BSD-style license |
| 5 | * that can be found in the LICENSE file in the root of the source |
| 6 | * tree. An additional intellectual property rights grant can be found |
| 7 | * in the file PATENTS. All contributing project authors may |
| 8 | * be found in the AUTHORS file in the root of the source tree. |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 9 | */ |
| 10 | |
Mirko Bonadei | 92ea95e | 2017-09-15 06:47:31 +0200 | [diff] [blame] | 11 | #ifndef MEDIA_BASE_RTPUTILS_H_ |
| 12 | #define MEDIA_BASE_RTPUTILS_H_ |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 13 | |
Mirko Bonadei | 92ea95e | 2017-09-15 06:47:31 +0200 | [diff] [blame] | 14 | #include "rtc_base/byteorder.h" |
Mirko Bonadei | 3d25530 | 2018-10-11 10:50:45 +0200 | [diff] [blame^] | 15 | #include "rtc_base/system/rtc_export.h" |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 16 | |
Sergey Ulanov | dc305db | 2016-01-14 17:14:54 -0800 | [diff] [blame] | 17 | namespace rtc { |
| 18 | struct PacketTimeUpdateParams; |
| 19 | } // namespace rtc |
| 20 | |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 21 | namespace cricket { |
| 22 | |
| 23 | const size_t kMinRtpPacketLen = 12; |
| 24 | const size_t kMaxRtpPacketLen = 2048; |
| 25 | const size_t kMinRtcpPacketLen = 4; |
| 26 | |
| 27 | struct RtpHeader { |
| 28 | int payload_type; |
| 29 | int seq_num; |
Peter Boström | 0c4e06b | 2015-10-07 12:23:21 +0200 | [diff] [blame] | 30 | uint32_t timestamp; |
| 31 | uint32_t ssrc; |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 32 | }; |
| 33 | |
| 34 | enum RtcpTypes { |
Yves Gerey | 665174f | 2018-06-19 15:03:05 +0200 | [diff] [blame] | 35 | kRtcpTypeSR = 200, // Sender report payload type. |
| 36 | kRtcpTypeRR = 201, // Receiver report payload type. |
| 37 | kRtcpTypeSDES = 202, // SDES payload type. |
| 38 | kRtcpTypeBye = 203, // BYE payload type. |
| 39 | kRtcpTypeApp = 204, // APP payload type. |
| 40 | kRtcpTypeRTPFB = 205, // Transport layer Feedback message payload type. |
| 41 | kRtcpTypePSFB = 206, // Payload-specific Feedback message payload type. |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 42 | }; |
| 43 | |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 44 | bool GetRtpPayloadType(const void* data, size_t len, int* value); |
| 45 | bool GetRtpSeqNum(const void* data, size_t len, int* value); |
Peter Boström | 0c4e06b | 2015-10-07 12:23:21 +0200 | [diff] [blame] | 46 | bool GetRtpTimestamp(const void* data, size_t len, uint32_t* value); |
| 47 | bool GetRtpSsrc(const void* data, size_t len, uint32_t* value); |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 48 | bool GetRtpHeaderLen(const void* data, size_t len, size_t* value); |
| 49 | bool GetRtcpType(const void* data, size_t len, int* value); |
Peter Boström | 0c4e06b | 2015-10-07 12:23:21 +0200 | [diff] [blame] | 50 | bool GetRtcpSsrc(const void* data, size_t len, uint32_t* value); |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 51 | bool GetRtpHeader(const void* data, size_t len, RtpHeader* header); |
| 52 | |
Peter Boström | 0c4e06b | 2015-10-07 12:23:21 +0200 | [diff] [blame] | 53 | bool SetRtpSsrc(void* data, size_t len, uint32_t value); |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 54 | // Assumes version 2, no padding, no extensions, no csrcs. |
| 55 | bool SetRtpHeader(void* data, size_t len, const RtpHeader& header); |
| 56 | |
buildbot@webrtc.org | 1ef789d | 2014-06-19 23:54:12 +0000 | [diff] [blame] | 57 | bool IsRtpPacket(const void* data, size_t len); |
pkasting@chromium.org | e9facf8 | 2015-02-17 20:36:28 +0000 | [diff] [blame] | 58 | |
Zhi Huang | 365381f | 2018-04-13 16:44:34 -0700 | [diff] [blame] | 59 | bool IsRtcpPacket(const char* data, size_t len); |
pkasting@chromium.org | e9facf8 | 2015-02-17 20:36:28 +0000 | [diff] [blame] | 60 | // True if |payload type| is 0-127. |
| 61 | bool IsValidRtpPayloadType(int payload_type); |
| 62 | |
zstein | 3dcf0e9 | 2017-06-01 13:22:42 -0700 | [diff] [blame] | 63 | // True if |size| is appropriate for the indicated packet type. |
| 64 | bool IsValidRtpRtcpPacketSize(bool rtcp, size_t size); |
| 65 | |
| 66 | // TODO(zstein): Consider using an enum instead of a bool to differentiate |
| 67 | // between RTP and RTCP. |
| 68 | // Returns "RTCP" or "RTP" according to |rtcp|. |
| 69 | const char* RtpRtcpStringLiteral(bool rtcp); |
| 70 | |
Sergey Ulanov | dc305db | 2016-01-14 17:14:54 -0800 | [diff] [blame] | 71 | // Verifies that a packet has a valid RTP header. |
Mirko Bonadei | 3d25530 | 2018-10-11 10:50:45 +0200 | [diff] [blame^] | 72 | bool RTC_EXPORT ValidateRtpHeader(const uint8_t* rtp, |
| 73 | size_t length, |
| 74 | size_t* header_length); |
Sergey Ulanov | dc305db | 2016-01-14 17:14:54 -0800 | [diff] [blame] | 75 | |
| 76 | // Helper method which updates the absolute send time extension if present. |
| 77 | bool UpdateRtpAbsSendTimeExtension(uint8_t* rtp, |
| 78 | size_t length, |
| 79 | int extension_id, |
| 80 | uint64_t time_us); |
| 81 | |
| 82 | // Applies specified |options| to the packet. It updates the absolute send time |
| 83 | // extension header if it is present present then updates HMAC. |
Mirko Bonadei | 3d25530 | 2018-10-11 10:50:45 +0200 | [diff] [blame^] | 84 | bool RTC_EXPORT |
| 85 | ApplyPacketOptions(uint8_t* data, |
| 86 | size_t length, |
| 87 | const rtc::PacketTimeUpdateParams& packet_time_params, |
| 88 | uint64_t time_us); |
Sergey Ulanov | dc305db | 2016-01-14 17:14:54 -0800 | [diff] [blame] | 89 | |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 90 | } // namespace cricket |
| 91 | |
Mirko Bonadei | 92ea95e | 2017-09-15 06:47:31 +0200 | [diff] [blame] | 92 | #endif // MEDIA_BASE_RTPUTILS_H_ |