1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768 |
- // Copyright (c) 2013 The Chromium Authors. All rights reserved.
- // Use of this source code is governed by a BSD-style license that can be
- // found in the LICENSE file.
- #ifndef MEDIA_FILTERS_STREAM_PARSER_FACTORY_H_
- #define MEDIA_FILTERS_STREAM_PARSER_FACTORY_H_
- #include <memory>
- #include <string>
- #include <vector>
- #include "base/containers/span.h"
- #include "media/base/media_export.h"
- #include "media/base/media_log.h"
- #include "media/base/mime_util.h"
- namespace media {
- class AudioDecoderConfig;
- class StreamParser;
- class VideoDecoderConfig;
- class MEDIA_EXPORT StreamParserFactory {
- public:
- // Checks to see if the specified |type| and |codecs| list are supported.
- // Returns one of the following SupportsType values:
- // kNotSupported indicates definitive lack of support.
- // kSupported indicates the mime type is supported, any non-empty codecs
- // requirement is met for the mime type, and all of the passed codecs are
- // supported for the mime type.
- // kMaybeSupported indicates the mime type is supported, but the mime type
- // requires a codecs parameter that is missing.
- static SupportsType IsTypeSupported(const std::string& type,
- base::span<const std::string> codecs);
- // Creates a new StreamParser object if the specified |type| and |codecs| list
- // are supported. |media_log| can be used to report errors if there is
- // something wrong with |type| or the codec IDs in |codecs|.
- // Returns a new StreamParser object if |type| and all codecs listed in
- // |codecs| are supported.
- // Returns NULL otherwise.
- // The |audio_config| and |video_config| overloads behave similarly, except
- // the caller must provide a valid, supported decoder config; those overloads'
- // usage indicates that we intend to buffer WebCodecs encoded audio or video
- // chunks with this parser's ProcessChunks() method. Note that
- // these overloads do not check support, unlike the |type| and |codecs|
- // version. Support checking for WebCodecs-originated decoder configs could be
- // async, and should be done by the caller if necessary as part of the decoder
- // config creation rather than relying upon parser creation to do this
- // potentially expensive step (this step is typically done in a synchronous
- // API call by the web app, such as addSourceBuffer().) Like |type| and
- // |codecs| versions, basic IsValidConfig() is done on configs emitted from
- // the parser. Failing that catching an unsupported config, eventual pipeline
- // error should occur for unsupported or invalid decoder configs during
- // attempted decode.
- static std::unique_ptr<StreamParser> Create(
- const std::string& type,
- base::span<const std::string> codecs,
- MediaLog* media_log);
- static std::unique_ptr<StreamParser> Create(
- std::unique_ptr<AudioDecoderConfig> audio_config);
- static std::unique_ptr<StreamParser> Create(
- std::unique_ptr<VideoDecoderConfig> video_config);
- };
- } // namespace media
- #endif // MEDIA_FILTERS_STREAM_PARSER_FACTORY_H_
|