Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(281)

Side by Side Diff: content/browser/media/session/media_session.h

Issue 1996043002: Split MediaContentType and AudioFocusType (Closed) Base URL: https://chromium.googlesource.com/chromium/src.git@master
Patch Set: addressed nits Created 4 years, 3 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View unified diff | Download patch
OLDNEW
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 CONTENT_BROWSER_MEDIA_SESSION_MEDIA_SESSION_H_ 5 #ifndef CONTENT_BROWSER_MEDIA_SESSION_MEDIA_SESSION_H_
6 #define CONTENT_BROWSER_MEDIA_SESSION_MEDIA_SESSION_H_ 6 #define CONTENT_BROWSER_MEDIA_SESSION_MEDIA_SESSION_H_
7 7
8 #include <stddef.h> 8 #include <stddef.h>
9 9
10 #include "base/callback_list.h" 10 #include "base/callback_list.h"
11 #include "base/id_map.h" 11 #include "base/id_map.h"
12 #include "base/macros.h" 12 #include "base/macros.h"
13 #include "content/browser/media/session/audio_focus_manager.h"
13 #include "content/browser/media/session/media_session_uma_helper.h" 14 #include "content/browser/media/session/media_session_uma_helper.h"
14 #include "content/common/content_export.h" 15 #include "content/common/content_export.h"
15 #include "content/public/browser/web_contents_observer.h" 16 #include "content/public/browser/web_contents_observer.h"
16 #include "content/public/browser/web_contents_user_data.h" 17 #include "content/public/browser/web_contents_user_data.h"
17 #include "content/public/common/media_metadata.h" 18 #include "content/public/common/media_metadata.h"
18 19
19 class MediaSessionBrowserTest; 20 class MediaSessionBrowserTest;
20 21
22 namespace media {
23 enum class MediaContentType;
24 } // namespace media
25
21 namespace content { 26 namespace content {
22 27
23 class AudioFocusManagerTest; 28 class AudioFocusManagerTest;
24 class MediaSessionDelegate; 29 class MediaSessionDelegate;
25 class MediaSessionObserver; 30 class MediaSessionObserver;
26 class MediaSessionStateObserver; 31 class MediaSessionStateObserver;
27 class MediaSessionVisibilityBrowserTest; 32 class MediaSessionVisibilityBrowserTest;
28 33
29 // MediaSession manages the media session and audio focus for a given 34 // MediaSession manages the media session and audio focus for a given
30 // WebContents. It is requesting the audio focus, pausing when requested by the 35 // WebContents. It is requesting the audio focus, pausing when requested by the
31 // system and dropping it on demand. 36 // system and dropping it on demand.
32 // The audio focus can be of two types: Transient or Content. A Transient audio 37 // The audio focus can be of two types: Transient or Content. A Transient audio
33 // focus will allow other players to duck instead of pausing and will be 38 // focus will allow other players to duck instead of pausing and will be
34 // declared as temporary to the system. A Content audio focus will not be 39 // declared as temporary to the system. A Content audio focus will not be
35 // declared as temporary and will not allow other players to duck. If a given 40 // declared as temporary and will not allow other players to duck. If a given
36 // WebContents can only have one audio focus at a time, it will be Content in 41 // WebContents can only have one audio focus at a time, it will be Content in
37 // case of Transient and Content audio focus are both requested. 42 // case of Transient and Content audio focus are both requested.
38 // TODO(thakis,mlamouri): MediaSession isn't CONTENT_EXPORT'd because it creates 43 // TODO(thakis,mlamouri): MediaSession isn't CONTENT_EXPORT'd because it creates
39 // complicated build issues with WebContentsUserData being a non-exported 44 // complicated build issues with WebContentsUserData being a non-exported
40 // template, see htttps://crbug.com/589840. As a result, the class uses 45 // template, see htttps://crbug.com/589840. As a result, the class uses
41 // CONTENT_EXPORT for methods that are being used from tests. CONTENT_EXPORT 46 // CONTENT_EXPORT for methods that are being used from tests. CONTENT_EXPORT
42 // should be moved back to the class when the Windows build will work with it. 47 // should be moved back to the class when the Windows build will work with it.
43 class MediaSession : public WebContentsObserver, 48 class MediaSession : public WebContentsObserver,
44 protected WebContentsUserData<MediaSession> { 49 protected WebContentsUserData<MediaSession> {
45 public: 50 public:
46 enum class Type {
47 Content,
48 Transient
49 };
50
51 enum class SuspendType { 51 enum class SuspendType {
52 // Suspended by the system because a transient sound needs to be played. 52 // Suspended by the system because a transient sound needs to be played.
53 SYSTEM, 53 SYSTEM,
54 // Suspended by the UI. 54 // Suspended by the UI.
55 UI, 55 UI,
56 // Suspended by the page via script or user interaction. 56 // Suspended by the page via script or user interaction.
57 CONTENT, 57 CONTENT,
58 }; 58 };
59 59
60 // Returns the MediaSession associated to this WebContents. Creates one if 60 // Returns the MediaSession associated to this WebContents. Creates one if
61 // none is currently available. 61 // none is currently available.
62 CONTENT_EXPORT static MediaSession* Get(WebContents* web_contents); 62 CONTENT_EXPORT static MediaSession* Get(WebContents* web_contents);
63 63
64 ~MediaSession() override; 64 ~MediaSession() override;
65 65
66 void SetMetadata(const MediaMetadata& metadata); 66 void SetMetadata(const MediaMetadata& metadata);
67 const MediaMetadata& metadata() const { return metadata_; } 67 const MediaMetadata& metadata() const { return metadata_; }
68 68
69 // Adds the given player to the current media session. Returns whether the 69 // Adds the given player to the current media session. Returns whether the
70 // player was successfully added. If it returns false, AddPlayer() should be 70 // player was successfully added. If it returns false, AddPlayer() should be
71 // called again later. 71 // called again later.
72 CONTENT_EXPORT bool AddPlayer(MediaSessionObserver* observer, 72 CONTENT_EXPORT bool AddPlayer(MediaSessionObserver* observer,
73 int player_id, Type type); 73 int player_id,
74 media::MediaContentType media_content_type);
74 75
75 // Removes the given player from the current media session. Abandons audio 76 // Removes the given player from the current media session. Abandons audio
76 // focus if that was the last player in the session. 77 // focus if that was the last player in the session.
77 CONTENT_EXPORT void RemovePlayer(MediaSessionObserver* observer, 78 CONTENT_EXPORT void RemovePlayer(MediaSessionObserver* observer,
78 int player_id); 79 int player_id);
79 80
80 // Removes all the players associated with |observer|. Abandons audio focus if 81 // Removes all the players associated with |observer|. Abandons audio focus if
81 // these were the last players in the session. 82 // these were the last players in the session.
82 CONTENT_EXPORT void RemovePlayers(MediaSessionObserver* observer); 83 CONTENT_EXPORT void RemovePlayers(MediaSessionObserver* observer);
83 84
84 // Record that the session was ducked. 85 // Record that the session was ducked.
85 void RecordSessionDuck(); 86 void RecordSessionDuck();
86 87
87 // Called when a player is paused in the content. 88 // Called when a player is paused in the content.
88 // If the paused player is the last player, we suspend the MediaSession. 89 // If the paused player is the last player, we suspend the MediaSession.
89 // Otherwise, the paused player will be removed from the MediaSession. 90 // Otherwise, the paused player will be removed from the MediaSession.
90 CONTENT_EXPORT void OnPlayerPaused(MediaSessionObserver* observer, 91 CONTENT_EXPORT void OnPlayerPaused(MediaSessionObserver* observer,
91 int player_id); 92 int player_id);
92 93
93 // Resume the media session. 94 // Resume the media session.
94 // |type| represents the origin of the request. 95 // |type| represents the origin of the request.
95 CONTENT_EXPORT void Resume(SuspendType type); 96 CONTENT_EXPORT void Resume(SuspendType suspend_type);
96 97
97 // Suspend the media session. 98 // Suspend the media session.
98 // |type| represents the origin of the request. 99 // |type| represents the origin of the request.
99 CONTENT_EXPORT void Suspend(SuspendType type); 100 CONTENT_EXPORT void Suspend(SuspendType suspend_type);
100 101
101 // Stop the media session. 102 // Stop the media session.
102 // |type| represents the origin of the request. 103 // |type| represents the origin of the request.
103 CONTENT_EXPORT void Stop(SuspendType type); 104 CONTENT_EXPORT void Stop(SuspendType suspend_type);
104 105
105 // Change the volume multiplier of the session to |volume_multiplier|. 106 // Change the volume multiplier of the session to |volume_multiplier|.
106 CONTENT_EXPORT void SetVolumeMultiplier(double volume_multiplier); 107 CONTENT_EXPORT void SetVolumeMultiplier(double volume_multiplier);
107 108
108 // Returns if the session can be controlled by Resume() and Suspend calls 109 // Returns if the session can be controlled by Resume() and Suspend calls
109 // above. 110 // above.
110 CONTENT_EXPORT bool IsControllable() const; 111 CONTENT_EXPORT bool IsControllable() const;
111 112
112 // Returns if the session is currently active. 113 // Returns if the session is currently active.
113 CONTENT_EXPORT bool IsActive() const; 114 CONTENT_EXPORT bool IsActive() const;
(...skipping 11 matching lines...) Expand all
125 private: 126 private:
126 friend class content::WebContentsUserData<MediaSession>; 127 friend class content::WebContentsUserData<MediaSession>;
127 friend class ::MediaSessionBrowserTest; 128 friend class ::MediaSessionBrowserTest;
128 friend class content::MediaSessionVisibilityBrowserTest; 129 friend class content::MediaSessionVisibilityBrowserTest;
129 friend class content::AudioFocusManagerTest; 130 friend class content::AudioFocusManagerTest;
130 friend class content::MediaSessionStateObserver; 131 friend class content::MediaSessionStateObserver;
131 132
132 CONTENT_EXPORT void SetDelegateForTests( 133 CONTENT_EXPORT void SetDelegateForTests(
133 std::unique_ptr<MediaSessionDelegate> delegate); 134 std::unique_ptr<MediaSessionDelegate> delegate);
134 CONTENT_EXPORT bool IsActiveForTest() const; 135 CONTENT_EXPORT bool IsActiveForTest() const;
135 CONTENT_EXPORT Type audio_focus_type_for_test() const; 136 CONTENT_EXPORT AudioFocusManager::AudioFocusType audio_focus_type_for_test()
137 const;
136 CONTENT_EXPORT void RemoveAllPlayersForTest(); 138 CONTENT_EXPORT void RemoveAllPlayersForTest();
137 CONTENT_EXPORT MediaSessionUmaHelper* uma_helper_for_test(); 139 CONTENT_EXPORT MediaSessionUmaHelper* uma_helper_for_test();
138 140
139 enum class State { 141 enum class State {
140 ACTIVE, 142 ACTIVE,
141 SUSPENDED, 143 SUSPENDED,
142 INACTIVE 144 INACTIVE
143 }; 145 };
144 146
145 // Representation of a player for the MediaSession. 147 // Representation of a player for the MediaSession.
(...skipping 12 matching lines...) Expand all
158 MediaSessionObserver* observer; 160 MediaSessionObserver* observer;
159 int player_id; 161 int player_id;
160 }; 162 };
161 using PlayersMap = base::hash_set<PlayerIdentifier, PlayerIdentifier::Hash>; 163 using PlayersMap = base::hash_set<PlayerIdentifier, PlayerIdentifier::Hash>;
162 using StateChangedCallback = base::Callback<void(State)>; 164 using StateChangedCallback = base::Callback<void(State)>;
163 165
164 CONTENT_EXPORT explicit MediaSession(WebContents* web_contents); 166 CONTENT_EXPORT explicit MediaSession(WebContents* web_contents);
165 167
166 void Initialize(); 168 void Initialize();
167 169
168 CONTENT_EXPORT void OnSuspendInternal(SuspendType type, State new_state); 170 CONTENT_EXPORT void OnSuspendInternal(SuspendType suspend_type,
169 CONTENT_EXPORT void OnResumeInternal(SuspendType type); 171 State new_state);
172 CONTENT_EXPORT void OnResumeInternal(SuspendType suspend_type);
170 173
171 // Requests audio focus to the MediaSessionDelegate. 174 // Requests audio focus to the MediaSessionDelegate.
172 // Returns whether the request was granted. 175 // Returns whether the request was granted.
173 bool RequestSystemAudioFocus(Type type); 176 bool RequestSystemAudioFocus(
177 AudioFocusManager::AudioFocusType audio_focus_type);
174 178
175 // To be called after a call to AbandonAudioFocus() in order request the 179 // To be called after a call to AbandonAudioFocus() in order request the
176 // delegate to abandon the audio focus. 180 // delegate to abandon the audio focus.
177 void AbandonSystemAudioFocusIfNeeded(); 181 void AbandonSystemAudioFocusIfNeeded();
178 182
179 // Notifies WebContents about the state change of the media session. 183 // Notifies WebContents about the state change of the media session.
180 void UpdateWebContents(); 184 void UpdateWebContents();
181 185
182 // Internal method that should be used instead of setting audio_focus_state_. 186 // Internal method that should be used instead of setting audio_focus_state_.
183 // It sets audio_focus_state_ and notifies observers about the state change. 187 // It sets audio_focus_state_ and notifies observers about the state change.
184 void SetAudioFocusState(State audio_focus_state); 188 void SetAudioFocusState(State audio_focus_state);
185 189
186 // Registers a MediaSession state change callback. 190 // Registers a MediaSession state change callback.
187 CONTENT_EXPORT std::unique_ptr<base::CallbackList<void(State)>::Subscription> 191 CONTENT_EXPORT std::unique_ptr<base::CallbackList<void(State)>::Subscription>
188 RegisterMediaSessionStateChangedCallbackForTest( 192 RegisterMediaSessionStateChangedCallbackForTest(
189 const StateChangedCallback& cb); 193 const StateChangedCallback& cb);
190 194
191 std::unique_ptr<MediaSessionDelegate> delegate_; 195 std::unique_ptr<MediaSessionDelegate> delegate_;
192 PlayersMap players_; 196 PlayersMap players_;
193 197
194 State audio_focus_state_; 198 State audio_focus_state_;
195 SuspendType suspend_type_; 199 SuspendType suspend_type_;
196 Type audio_focus_type_; 200 AudioFocusManager::AudioFocusType audio_focus_type_;
197 201
198 MediaSessionUmaHelper uma_helper_; 202 MediaSessionUmaHelper uma_helper_;
199 203
200 // The volume multiplier of this session. All players in this session should 204 // The volume multiplier of this session. All players in this session should
201 // multiply their volume with this multiplier to get the effective volume. 205 // multiply their volume with this multiplier to get the effective volume.
202 double volume_multiplier_; 206 double volume_multiplier_;
203 207
204 MediaMetadata metadata_; 208 MediaMetadata metadata_;
205 base::CallbackList<void(State)> media_session_state_listeners_; 209 base::CallbackList<void(State)> media_session_state_listeners_;
206 210
207 DISALLOW_COPY_AND_ASSIGN(MediaSession); 211 DISALLOW_COPY_AND_ASSIGN(MediaSession);
208 }; 212 };
209 213
210 } // namespace content 214 } // namespace content
211 215
212 #endif // CONTENT_BROWSER_MEDIA_SESSION_MEDIA_SESSION_H_ 216 #endif // CONTENT_BROWSER_MEDIA_SESSION_MEDIA_SESSION_H_
OLDNEW
« no previous file with comments | « content/browser/media/media_web_contents_observer.cc ('k') | content/browser/media/session/media_session.cc » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698