mirror of
https://github.com/mollyim/webrtc.git
synced 2025-05-12 21:30:45 +01:00
a9d7c19011
Bug: b/336978562 Change-Id: Icc9be7a5ad095304bf68e19ffedca77d8bc1810c Reviewed-on: https://webrtc-review.googlesource.com/c/src/+/349266 Commit-Queue: Philip Eliasson <philipel@webrtc.org> Reviewed-by: Erik Språng <sprang@webrtc.org> Cr-Commit-Position: refs/heads/main@{#42285}
85 lines
2.6 KiB
C++
85 lines
2.6 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 <map>
|
|
#include <memory>
|
|
#include <string>
|
|
#include <utility>
|
|
#include <vector>
|
|
|
|
#include "absl/functional/any_invocable.h"
|
|
#include "absl/types/optional.h"
|
|
#include "absl/types/variant.h"
|
|
#include "api/units/data_rate.h"
|
|
#include "api/units/time_delta.h"
|
|
#include "api/units/timestamp.h"
|
|
#include "api/video/encoded_image.h"
|
|
#include "api/video/resolution.h"
|
|
#include "api/video/video_frame.h"
|
|
#include "api/video_codecs/video_codec.h"
|
|
#include "api/video_codecs/video_encoding_general.h"
|
|
#include "rtc_base/numerics/rational.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 TemporalUnitSettings {
|
|
VideoCodecMode content_hint = VideoCodecMode::kRealtimeVideo;
|
|
Timestamp presentation_timestamp;
|
|
int effort_level = 0;
|
|
};
|
|
|
|
// Results from calling Encode. Called once for each configured frame.
|
|
struct EncodingError {};
|
|
struct EncodedData {
|
|
rtc::scoped_refptr<EncodedImageBufferInterface> bitstream_data;
|
|
FrameType frame_type;
|
|
int encoded_qp;
|
|
};
|
|
using EncodeResult = absl::variant<EncodingError, EncodedData>;
|
|
using EncodeResultCallback =
|
|
absl::AnyInvocable<void(const EncodeResult& result) &&>;
|
|
|
|
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;
|
|
absl::optional<int> update_buffer;
|
|
|
|
EncodeResultCallback result_callback;
|
|
};
|
|
|
|
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_
|