1 /*
2  * Copyright (C) 2013 Google Inc. All rights reserved.
3  *
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions are
6  * met:
7  *
8  *     * Redistributions of source code must retain the above copyright
9  * notice, this list of conditions and the following disclaimer.
10  *     * Redistributions in binary form must reproduce the above
11  * copyright notice, this list of conditions and the following disclaimer
12  * in the documentation and/or other materials provided with the
13  * distribution.
14  *     * Neither the name of Google Inc. nor the names of its
15  * contributors may be used to endorse or promote products derived from
16  * this software without specific prior written permission.
17  *
18  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
19  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
20  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
21  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
22  * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
23  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
24  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
25  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
26  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
27  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
28  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
29  */
30 
31 #ifndef THIRD_PARTY_BLINK_PUBLIC_PLATFORM_WEB_MEDIA_SOURCE_H_
32 #define THIRD_PARTY_BLINK_PUBLIC_PLATFORM_WEB_MEDIA_SOURCE_H_
33 
34 #include "third_party/blink/public/platform/web_string.h"
35 #include "third_party/blink/public/platform/web_time_range.h"
36 #include "third_party/blink/public/platform/web_url.h"
37 
38 namespace blink {
39 
40 class WebSourceBuffer;
41 
42 class WebMediaSource {
43  public:
44   enum AddStatus {
45     kAddStatusOk,
46     kAddStatusNotSupported,
47     kAddStatusReachedIdLimit
48   };
49 
50   enum EndOfStreamStatus {
51     kEndOfStreamStatusNoError,
52     kEndOfStreamStatusNetworkError,
53     kEndOfStreamStatusDecodeError,
54   };
55 
56   virtual ~WebMediaSource() = default;
57 
58   // Attempts to create a new WebSourceBuffer for use with this WebMediaSource.
59   // |content_type| is the ContentType string of the new WebSourceBuffer
60   // bytestream's MIME type, and |codecs| contains the "codecs" parameter
61   // string, if any, of the bytestream's MIME type.
62   // If this WebMediaSource supports the format indicated by |content_type| and
63   // |codecs| and has enough resources to support a new WebSourceBuffer, returns
64   // kAddStatusOk and creates a new WebSourceBuffer and changes the
65   // WebSourceBuffer parameter to point to it.
66   // If this WebMediaSource cannot handle another WebSourceBuffer right now,
67   // returns kAddStatusReachedIdLimit without modifying the WebSourceBuffer
68   // parameter.
69   // If |content_type| and |codecs| are not supported, returns
70   // kAddStatusNotSupported without modifying the WebSourceBuffer parameter.
71   virtual AddStatus AddSourceBuffer(const WebString& content_type,
72                                     const WebString& codecs,
73                                     WebSourceBuffer**) = 0;
74 
75   virtual double Duration() = 0;
76   virtual void SetDuration(double) = 0;
77   virtual void MarkEndOfStream(EndOfStreamStatus) = 0;
78   virtual void UnmarkEndOfStream() = 0;
79 };
80 
81 }  // namespace blink
82 
83 #endif
84