mirror of
https://github.com/mollyim/webrtc.git
synced 2025-05-14 06:10:40 +01:00
8037fc6ffa
Bug: webrtc:342905193 No-Try: True Change-Id: Icc968be43b8830038ea9a1f5f604307220457807 Reviewed-on: https://webrtc-review.googlesource.com/c/src/+/361021 Auto-Submit: Florent Castelli <orphis@webrtc.org> Reviewed-by: Harald Alvestrand <hta@webrtc.org> Commit-Queue: Florent Castelli <orphis@webrtc.org> Cr-Commit-Position: refs/heads/main@{#42911}
84 lines
2.4 KiB
C++
84 lines
2.4 KiB
C++
/*
|
|
* Copyright (c) 2023 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 API_VIDEO_CODECS_VIDEO_ENCODER_INTERFACE_H_
|
|
#define API_VIDEO_CODECS_VIDEO_ENCODER_INTERFACE_H_
|
|
|
|
#include <cstdint>
|
|
#include <memory>
|
|
#include <optional>
|
|
#include <vector>
|
|
|
|
#include "absl/types/variant.h"
|
|
#include "api/array_view.h"
|
|
#include "api/scoped_refptr.h"
|
|
#include "api/units/data_rate.h"
|
|
#include "api/units/data_size.h"
|
|
#include "api/units/time_delta.h"
|
|
#include "api/units/timestamp.h"
|
|
#include "api/video/resolution.h"
|
|
#include "api/video/video_frame_buffer.h"
|
|
#include "api/video_codecs/video_codec.h"
|
|
|
|
namespace webrtc {
|
|
// NOTE: This class is still under development and may change without notice.
|
|
class VideoEncoderInterface {
|
|
public:
|
|
virtual ~VideoEncoderInterface() = default;
|
|
enum class FrameType { kKeyframe, kStartFrame, kDeltaFrame };
|
|
|
|
struct EncodingError {};
|
|
struct EncodedData {
|
|
FrameType frame_type;
|
|
int encoded_qp;
|
|
};
|
|
using EncodeResult = absl::variant<EncodingError, EncodedData>;
|
|
|
|
struct FrameOutput {
|
|
virtual ~FrameOutput() = default;
|
|
virtual rtc::ArrayView<uint8_t> GetBitstreamOutputBuffer(DataSize size) = 0;
|
|
virtual void EncodeComplete(const EncodeResult& encode_result) = 0;
|
|
};
|
|
|
|
struct TemporalUnitSettings {
|
|
VideoCodecMode content_hint = VideoCodecMode::kRealtimeVideo;
|
|
Timestamp presentation_timestamp;
|
|
};
|
|
|
|
struct FrameEncodeSettings {
|
|
struct Cbr {
|
|
TimeDelta duration;
|
|
DataRate target_bitrate;
|
|
};
|
|
|
|
struct Cqp {
|
|
int target_qp;
|
|
};
|
|
|
|
absl::variant<Cqp, Cbr> rate_options;
|
|
|
|
FrameType frame_type = FrameType::kDeltaFrame;
|
|
int temporal_id = 0;
|
|
int spatial_id = 0;
|
|
Resolution resolution;
|
|
std::vector<int> reference_buffers;
|
|
std::optional<int> update_buffer;
|
|
int effort_level = 0;
|
|
|
|
std::unique_ptr<FrameOutput> frame_output;
|
|
};
|
|
|
|
virtual void Encode(rtc::scoped_refptr<webrtc::VideoFrameBuffer> frame_buffer,
|
|
const TemporalUnitSettings& settings,
|
|
std::vector<FrameEncodeSettings> frame_settings) = 0;
|
|
};
|
|
|
|
} // namespace webrtc
|
|
#endif // API_VIDEO_CODECS_VIDEO_ENCODER_INTERFACE_H_
|