1 files changed, 68 insertions, 0 deletions
diff --git a/dom/media/DecoderTraits.h b/dom/media/DecoderTraits.h
new file mode 100644
index 000000000..8e6d73d94
--- /dev/null
+++ b/dom/media/DecoderTraits.h
@@ -0,0 +1,68 @@
+/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
+/* vim:set ts=2 sw=2 sts=2 et cindent: */
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
+
+#ifndef DecoderTraits_h_
+#define DecoderTraits_h_
+
+#include "nsCOMPtr.h"
+
+class nsAString;
+class nsACString;
+
+namespace mozilla {
+
+class AbstractMediaDecoder;
+class DecoderDoctorDiagnostics;
+class MediaContentType;
+class MediaDecoder;
+class MediaDecoderOwner;
+class MediaDecoderReader;
+
+enum CanPlayStatus {
+  CANPLAY_NO,
+  CANPLAY_MAYBE,
+  CANPLAY_YES
+};
+
+class DecoderTraits {
+public:
+  // Returns the CanPlayStatus indicating if we can handle this content type.
+  static CanPlayStatus CanHandleContentType(const MediaContentType& aContentType,
+                                            DecoderDoctorDiagnostics* aDiagnostics);
+
+  // Returns true if we should handle this MIME type when it appears
+  // as an <object> or as a toplevel page. If, in practice, our support
+  // for the type is more limited than appears in the wild, we should return
+  // false here even if CanHandleMediaType would return true.
+  static bool ShouldHandleMediaType(const char* aMIMEType,
+                                    DecoderDoctorDiagnostics* aDiagnostics);
+
+  // Create a decoder for the given aType. Returns null if we
+  // were unable to create the decoder.
+  static already_AddRefed<MediaDecoder> CreateDecoder(const nsACString& aType,
+                                                      MediaDecoderOwner* aOwner,
+                                                      DecoderDoctorDiagnostics* aDiagnostics);
+
+  // Create a reader for thew given MIME type aType. Returns null
+  // if we were unable to create the reader.
+  static MediaDecoderReader* CreateReader(const nsACString& aType,
+                                          AbstractMediaDecoder* aDecoder);
+
+  // Returns true if MIME type aType is supported in video documents,
+  // or false otherwise. Not all platforms support all MIME types, and
+  // vice versa.
+  static bool IsSupportedInVideoDocument(const nsACString& aType);
+
+  static bool IsWebMTypeAndEnabled(const nsACString& aType);
+  static bool IsWebMAudioType(const nsACString& aType);
+  static bool IsMP4TypeAndEnabled(const nsACString& aType,
+                                  DecoderDoctorDiagnostics* aDiagnostics);
+};
+
+} // namespace mozilla
+
+#endif
+