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