mirror of
https://github.com/mollyim/webrtc.git
synced 2025-05-14 14:20:45 +01:00
2b781bf908
This member of the CodecInfo struct was set in several places, but not used for anything. To aid deletion, this cl defines a default implementation of VideoEncoderFactory::QueryVideoEncoder. The next step is to delete almost all downstream implementations of that method, since the only classes that have to implement it are the few factories that produce "internal source" encoders, e.g., for Chromium remoting. Bug: None Change-Id: I1f0dbf0d302933004ebdc779460cb2cb3a894e02 Reviewed-on: https://webrtc-review.googlesource.com/c/src/+/179520 Reviewed-by: Kári Helgason <kthelgason@webrtc.org> Reviewed-by: Sami Kalliomäki <sakal@webrtc.org> Reviewed-by: Sebastian Jansson <srte@webrtc.org> Commit-Queue: Niels Moller <nisse@webrtc.org> Cr-Commit-Position: refs/heads/master@{#31844}
79 lines
3.4 KiB
C++
79 lines
3.4 KiB
C++
/*
|
|
* Copyright (c) 2017 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 MEDIA_ENGINE_MULTIPLEX_CODEC_FACTORY_H_
|
|
#define MEDIA_ENGINE_MULTIPLEX_CODEC_FACTORY_H_
|
|
|
|
#include <memory>
|
|
#include <vector>
|
|
|
|
#include "api/video_codecs/sdp_video_format.h"
|
|
#include "api/video_codecs/video_decoder.h"
|
|
#include "api/video_codecs/video_decoder_factory.h"
|
|
#include "api/video_codecs/video_encoder.h"
|
|
#include "api/video_codecs/video_encoder_factory.h"
|
|
#include "rtc_base/system/rtc_export.h"
|
|
|
|
namespace webrtc {
|
|
// Multiplex codec is a completely modular/optional codec that allows users to
|
|
// send more than a frame's opaque content(RGB/YUV) over video channels.
|
|
// - Allows sending Alpha channel over the wire iff input is
|
|
// I420ABufferInterface. Users can expect to receive I420ABufferInterface as the
|
|
// decoded video frame buffer. I420A data is split into YUV/AXX portions,
|
|
// encoded/decoded seperately and bitstreams are concatanated.
|
|
// - Allows sending augmenting data over the wire attached to the frame. This
|
|
// attached data portion is not encoded in any way and sent as it is. Users can
|
|
// input AugmentedVideoFrameBuffer and can expect the same interface as the
|
|
// decoded video frame buffer.
|
|
// - Showcases an example of how to add a custom codec in webrtc video channel.
|
|
// How to use it end-to-end:
|
|
// - Wrap your existing VideoEncoderFactory implemention with
|
|
// MultiplexEncoderFactory and VideoDecoderFactory implemention with
|
|
// MultiplexDecoderFactory below. For actual coding, multiplex creates encoder
|
|
// and decoder instance(s) using these factories.
|
|
// - Use Multiplex*coderFactory classes in CreatePeerConnectionFactory() calls.
|
|
// - Select "multiplex" codec in SDP negotiation.
|
|
class RTC_EXPORT MultiplexEncoderFactory : public VideoEncoderFactory {
|
|
public:
|
|
// |supports_augmenting_data| defines if the encoder would support augmenting
|
|
// data. If set, the encoder expects to receive video frame buffers of type
|
|
// AugmentedVideoFrameBuffer.
|
|
MultiplexEncoderFactory(std::unique_ptr<VideoEncoderFactory> factory,
|
|
bool supports_augmenting_data = false);
|
|
|
|
std::vector<SdpVideoFormat> GetSupportedFormats() const override;
|
|
std::unique_ptr<VideoEncoder> CreateVideoEncoder(
|
|
const SdpVideoFormat& format) override;
|
|
|
|
private:
|
|
std::unique_ptr<VideoEncoderFactory> factory_;
|
|
const bool supports_augmenting_data_;
|
|
};
|
|
|
|
class RTC_EXPORT MultiplexDecoderFactory : public VideoDecoderFactory {
|
|
public:
|
|
// |supports_augmenting_data| defines if the decoder would support augmenting
|
|
// data. If set, the decoder is expected to output video frame buffers of type
|
|
// AugmentedVideoFrameBuffer.
|
|
MultiplexDecoderFactory(std::unique_ptr<VideoDecoderFactory> factory,
|
|
bool supports_augmenting_data = false);
|
|
|
|
std::vector<SdpVideoFormat> GetSupportedFormats() const override;
|
|
std::unique_ptr<VideoDecoder> CreateVideoDecoder(
|
|
const SdpVideoFormat& format) override;
|
|
|
|
private:
|
|
std::unique_ptr<VideoDecoderFactory> factory_;
|
|
const bool supports_augmenting_data_;
|
|
};
|
|
|
|
} // namespace webrtc
|
|
|
|
#endif // MEDIA_ENGINE_MULTIPLEX_CODEC_FACTORY_H_
|