[M120 Migration][MM] Framerate calculation

[platform/framework/web/chromium-efl.git] / media / filters / stream_parser_factory.h

diff --git a/media/filters/stream_parser_factory.h b/media/filters/stream_parser_factory.h
index e879c70..57d87ab 100644 (file)
--- a/media/filters/stream_parser_factory.h
+++ b/media/filters/stream_parser_factory.h
@@ -1,4 +1,4 @@
-// Copyright (c) 2013 The Chromium Authors. All rights reserved.
+// Copyright 2013 The Chromium Authors
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
@@ -9,19 +9,30 @@
 #include <string>
 #include <vector>
 
+#include "base/containers/span.h"
+#include "base/strings/string_piece_forward.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 true if |type| and all codecs listed in |codecs| are supported.
-  static bool IsTypeSupported(
-      const std::string& type, const std::vector<std::string>& codecs);
+  // 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(base::StringPiece 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
@@ -29,10 +40,30 @@ class MEDIA_EXPORT StreamParserFactory {
   // 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,
-      const std::vector<std::string>& codecs,
-      MediaLog* media_log);
+      base::StringPiece type,
+      base::span<const std::string> codecs,
+      MediaLog* media_log,
+      bool* has_audio,
+      bool* has_video);
+  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