OLD | NEW |
1 /* | 1 /* |
2 * Copyright (C) 2013 Google Inc. All rights reserved. | 2 * Copyright (C) 2013 Google Inc. All rights reserved. |
3 * | 3 * |
4 * Redistribution and use in source and binary forms, with or without | 4 * Redistribution and use in source and binary forms, with or without |
5 * modification, are permitted provided that the following conditions are | 5 * modification, are permitted provided that the following conditions are |
6 * met: | 6 * met: |
7 * | 7 * |
8 * * Redistributions of source code must retain the above copyright | 8 * * Redistributions of source code must retain the above copyright |
9 * notice, this list of conditions and the following disclaimer. | 9 * notice, this list of conditions and the following disclaimer. |
10 * * Redistributions in binary form must reproduce the above | 10 * * Redistributions in binary form must reproduce the above |
(...skipping 19 matching lines...) Expand all Loading... |
30 | 30 |
31 #ifndef WebSourceBuffer_h | 31 #ifndef WebSourceBuffer_h |
32 #define WebSourceBuffer_h | 32 #define WebSourceBuffer_h |
33 | 33 |
34 #include "WebTimeRange.h" | 34 #include "WebTimeRange.h" |
35 | 35 |
36 namespace blink { | 36 namespace blink { |
37 | 37 |
38 class WebSourceBufferClient; | 38 class WebSourceBufferClient; |
39 | 39 |
| 40 // Interface for actuating the media engine implementation of Media Source |
| 41 // extension's SourceBuffer. See also the mediasource module in Blink, and the |
| 42 // WebSourceBufferClient interface. |
40 class WebSourceBuffer { | 43 class WebSourceBuffer { |
41 public: | 44 public: |
42 enum AppendMode { | 45 enum AppendMode { |
43 AppendModeSegments, | 46 AppendModeSegments, |
44 AppendModeSequence | 47 AppendModeSequence |
45 }; | 48 }; |
46 | 49 |
47 virtual ~WebSourceBuffer() { } | 50 virtual ~WebSourceBuffer() { } |
48 | 51 |
49 // This will only be called once and only with a non-null pointer to a | 52 // This will only be called once and only with a non-null pointer to a |
50 // client whose ownership is not transferred to this WebSourceBuffer. | 53 // client whose ownership is not transferred to this WebSourceBuffer. |
51 virtual void setClient(WebSourceBufferClient*) = 0; | 54 virtual void setClient(WebSourceBufferClient*) = 0; |
52 | 55 |
53 virtual bool setMode(AppendMode) = 0; | 56 virtual bool setMode(AppendMode) = 0; |
54 virtual WebTimeRanges buffered() = 0; | 57 virtual WebTimeRanges buffered() = 0; |
55 | 58 |
56 // Run coded frame eviction/garbage collection algorithm. | 59 // Run coded frame eviction/garbage collection algorithm. |
57 // |currentPlaybackTime| is HTMLMediaElement::currentTime. The algorithm | 60 // |currentPlaybackTime| is HTMLMediaElement::currentTime. The algorithm |
58 // will try to preserve data around current playback position. | 61 // will try to preserve data around current playback position. |
59 // |newDataSize| is size of new data about to be appended to SourceBuffer. | 62 // |newDataSize| is size of new data about to be appended to SourceBuffer. |
60 // Could be zero for appendStream if stream size is unknown in advance. | 63 // Could be zero for appendStream if stream size is unknown in advance. |
61 // Returns false if buffer is still full after eviction. | 64 // Returns false if buffer is still full after eviction. |
62 virtual bool evictCodedFrames(double currentPlaybackTime, size_t newDataSize
) = 0; | 65 virtual bool evictCodedFrames(double currentPlaybackTime, size_t newDataSize
) = 0; |
63 | 66 |
64 // Appends data and runs the segment parser loop algorithm. | 67 // Appends data and runs the segment parser loop algorithm. |
65 // The algorithm may update |*timestampOffset| if |timestampOffset| is not n
ull. | 68 // The algorithm may update |*timestampOffset| if |timestampOffset| is not n
ull. |
66 virtual void append(const unsigned char* data, unsigned length, double* time
stampOffset) = 0; | 69 // Returns true on success, otherwise the append error algorithm needs to |
| 70 // run with the decode error parameter set to true. |
| 71 virtual bool append(const unsigned char* data, unsigned length, double* time
stampOffset) = 0; |
67 | 72 |
68 virtual void resetParserState() = 0; | 73 virtual void resetParserState() = 0; |
69 virtual void remove(double start, double end) = 0; | 74 virtual void remove(double start, double end) = 0; |
70 virtual bool setTimestampOffset(double) = 0; | 75 virtual bool setTimestampOffset(double) = 0; |
71 | 76 |
72 // Set presentation timestamp for the start of append window. | 77 // Set presentation timestamp for the start of append window. |
73 virtual void setAppendWindowStart(double) = 0; | 78 virtual void setAppendWindowStart(double) = 0; |
74 | 79 |
75 // Set presentation timestamp for the end of append window. | 80 // Set presentation timestamp for the end of append window. |
76 virtual void setAppendWindowEnd(double) = 0; | 81 virtual void setAppendWindowEnd(double) = 0; |
77 | 82 |
78 // After this method is called, this WebSourceBuffer should never use the | 83 // After this method is called, this WebSourceBuffer should never use the |
79 // client pointer passed to setClient(). | 84 // client pointer passed to setClient(). |
80 virtual void removedFromMediaSource() = 0; | 85 virtual void removedFromMediaSource() = 0; |
81 }; | 86 }; |
82 | 87 |
83 } // namespace blink | 88 } // namespace blink |
84 | 89 |
85 #endif | 90 #endif |
OLD | NEW |