video_stream_encoder_settings.h

/******************************************************************************
 *  Copyright (c) 2025 The CRTC project authors . All Rights Reserved.
 *
 *  Please visit https://chensongpoixs.github.io for detail
 *
 *  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.
 ******************************************************************************/
 /*****************************************************************************
				   Author: chensong
				   date:  2025-09-25



 ******************************************************************************/


#ifndef _C_API_VIDEO_VIDEO_STREAM_ENCODER_SETTINGS_H_
#define _C_API_VIDEO_VIDEO_STREAM_ENCODER_SETTINGS_H_

#include <string>

#include "libmedia_codec/video_bitrate_allocator_factory.h"
#include "libmedia_codec/video_codecs/video_encoder.h"
#include "libmedia_codec/video_codecs/video_encoder_factory.h"

namespace libmedia_codec {

class EncoderSwitchRequestCallback {
 public:
  virtual ~EncoderSwitchRequestCallback() {}

  struct Config {
    std::string codec_name;
    absl::optional<std::string> param;
    absl::optional<std::string> value;
  };

  // Requests that encoder fallback is performed.
  virtual void RequestEncoderFallback() = 0;

  // Requests that a switch to a specific encoder is performed.
  virtual void RequestEncoderSwitch(const Config& conf) = 0;

  virtual void RequestEncoderSwitch(const SdpVideoFormat& format) = 0;
};

struct VideoStreamEncoderSettings {
  explicit VideoStreamEncoderSettings(
      const VideoEncoder::Capabilities& capabilities)
      : capabilities(capabilities) {}

  // Enables the new method to estimate the cpu load from encoding, used for
  // cpu adaptation.
  bool experiment_cpu_load_estimator = false;

  // Ownership stays with WebrtcVideoEngine (delegated from PeerConnection).
  VideoEncoderFactory* encoder_factory = nullptr;

  // Requests the WebRtcVideoChannel to perform a codec switch.
  EncoderSwitchRequestCallback* encoder_switch_request_callback = nullptr;

  // Ownership stays with WebrtcVideoEngine (delegated from PeerConnection).
  VideoBitrateAllocatorFactory* bitrate_allocator_factory = nullptr;

  // Negotiated capabilities which the VideoEncoder may expect the other
  // side to use.
  VideoEncoder::Capabilities capabilities;
};

}  // namespace webrtc

#endif  // API_VIDEO_VIDEO_STREAM_ENCODER_SETTINGS_H_