| OLD | NEW |
| 1 // Copyright 2015 The Chromium Authors. All rights reserved. | 1 // Copyright 2015 The Chromium Authors. All rights reserved. |
| 2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
| 3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
| 4 | 4 |
| 5 #ifndef MediaMetadata_h | 5 #ifndef MediaMetadata_h |
| 6 #define MediaMetadata_h | 6 #define MediaMetadata_h |
| 7 | 7 |
| 8 #include "bindings/core/v8/ScriptWrappable.h" | 8 #include "bindings/core/v8/ScriptWrappable.h" |
| 9 #include "modules/ModulesExport.h" | 9 #include "modules/ModulesExport.h" |
| 10 #include "platform/Timer.h" | 10 #include "platform/Timer.h" |
| 11 #include "platform/heap/Handle.h" | 11 #include "platform/heap/Handle.h" |
| 12 #include "wtf/text/WTFString.h" | 12 #include "wtf/text/WTFString.h" |
| 13 | 13 |
| 14 namespace blink { | 14 namespace blink { |
| 15 | 15 |
| 16 class ExecutionContext; | 16 class ExceptionState; |
| 17 class MediaImage; | 17 class MediaImage; |
| 18 class MediaMetadataInit; | 18 class MediaMetadataInit; |
| 19 class MediaSession; | 19 class MediaSession; |
| 20 class ScriptState; |
| 20 | 21 |
| 21 // Implementation of MediaMetadata interface from the Media Session API. | 22 // Implementation of MediaMetadata interface from the Media Session API. |
| 22 // The MediaMetadata object is linked to a MediaSession that owns it. When one | 23 // The MediaMetadata object is linked to a MediaSession that owns it. When one |
| 23 // of its properties are updated, the object will notify its MediaSession if | 24 // of its properties are updated, the object will notify its MediaSession if |
| 24 // any. The notification will be made asynchronously in order to combine changes | 25 // any. The notification will be made asynchronously in order to combine changes |
| 25 // made inside the same event loop. When a MediaMetadata is created and assigned | 26 // made inside the same event loop. When a MediaMetadata is created and assigned |
| 26 // to a MediaSession, the MediaSession will automatically update. | 27 // to a MediaSession, the MediaSession will automatically update. |
| 27 class MODULES_EXPORT MediaMetadata final | 28 class MODULES_EXPORT MediaMetadata final |
| 28 : public GarbageCollectedFinalized<MediaMetadata>, | 29 : public GarbageCollectedFinalized<MediaMetadata>, |
| 29 public ScriptWrappable { | 30 public ScriptWrappable { |
| 30 DEFINE_WRAPPERTYPEINFO(); | 31 DEFINE_WRAPPERTYPEINFO(); |
| 31 | 32 |
| 32 public: | 33 public: |
| 33 static MediaMetadata* create(ExecutionContext*, const MediaMetadataInit&); | 34 static MediaMetadata* create(ScriptState*, |
| 35 const MediaMetadataInit&, |
| 36 ExceptionState&); |
| 34 | 37 |
| 35 String title() const; | 38 String title() const; |
| 36 String artist() const; | 39 String artist() const; |
| 37 String album() const; | 40 String album() const; |
| 38 const HeapVector<Member<MediaImage>>& artwork() const; | 41 Vector<v8::Local<v8::Value>> artwork(ScriptState*) const; |
| 42 |
| 43 // Internal use only, returns a reference to m_artwork instead of a Frozen |
| 44 // copy of a MediaImage array. |
| 45 const HeapVector<MediaImage>& artwork() const; |
| 39 | 46 |
| 40 void setTitle(const String&); | 47 void setTitle(const String&); |
| 41 void setArtist(const String&); | 48 void setArtist(const String&); |
| 42 void setAlbum(const String&); | 49 void setAlbum(const String&); |
| 43 void setArtwork(const HeapVector<Member<MediaImage>>&); | 50 void setArtwork(ScriptState*, const HeapVector<MediaImage>&, ExceptionState&); |
| 44 | 51 |
| 45 // Called by MediaSession to associate or de-associate itself. | 52 // Called by MediaSession to associate or de-associate itself. |
| 46 void setSession(MediaSession*); | 53 void setSession(MediaSession*); |
| 47 | 54 |
| 48 DECLARE_VIRTUAL_TRACE(); | 55 DECLARE_VIRTUAL_TRACE(); |
| 49 | 56 |
| 50 private: | 57 private: |
| 51 MediaMetadata(ExecutionContext*, const MediaMetadataInit&); | 58 MediaMetadata(ScriptState*, const MediaMetadataInit&, ExceptionState&); |
| 52 | 59 |
| 53 // Called when one of the metadata fields is updated from script. It will | 60 // Called when one of the metadata fields is updated from script. It will |
| 54 // notify the session asynchronously in order to bundle multiple call in one | 61 // notify the session asynchronously in order to bundle multiple call in one |
| 55 // notification. | 62 // notification. |
| 56 void notifySessionAsync(); | 63 void notifySessionAsync(); |
| 57 | 64 |
| 58 // Called asynchronously after at least one field of MediaMetadata has been | 65 // Called asynchronously after at least one field of MediaMetadata has been |
| 59 // modified. | 66 // modified. |
| 60 void notifySessionTimerFired(TimerBase*); | 67 void notifySessionTimerFired(TimerBase*); |
| 61 | 68 |
| 69 // Make an internal copy of the MediaImage vector with some internal steps |
| 70 // such as parsing of the src property. |
| 71 void setArtworkInternal(ScriptState*, |
| 72 const HeapVector<MediaImage>&, |
| 73 ExceptionState&); |
| 74 |
| 62 String m_title; | 75 String m_title; |
| 63 String m_artist; | 76 String m_artist; |
| 64 String m_album; | 77 String m_album; |
| 65 HeapVector<Member<MediaImage>> m_artwork; | 78 HeapVector<MediaImage> m_artwork; |
| 66 | 79 |
| 67 Member<MediaSession> m_session; | 80 Member<MediaSession> m_session; |
| 68 Timer<MediaMetadata> m_notifySessionTimer; | 81 Timer<MediaMetadata> m_notifySessionTimer; |
| 69 }; | 82 }; |
| 70 | 83 |
| 71 } // namespace blink | 84 } // namespace blink |
| 72 | 85 |
| 73 #endif // MediaMetadata_h | 86 #endif // MediaMetadata_h |
| OLD | NEW |