/* * Copyright (C) 2013-2021 Apple Inc. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions * are met: * 1. Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * 2. Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * THIS SOFTWARE IS PROVIDED BY APPLE INC. AND ITS CONTRIBUTORS ``AS IS'' * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL APPLE INC. OR ITS CONTRIBUTORS * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF * THE POSSIBILITY OF SUCH DAMAGE. */ #ifndef PlatformMediaSessionManager_h #define PlatformMediaSessionManager_h #include "MediaUniqueIdentifier.h" #include "PlatformMediaSession.h" #include "RemoteCommandListener.h" #include "Timer.h" #include #include #include #include namespace WebCore { class PlatformMediaSession; class PlatformMediaSessionManager #if !RELEASE_LOG_DISABLED : private LoggerHelper #endif { WTF_MAKE_FAST_ALLOCATED; public: WEBCORE_EXPORT static PlatformMediaSessionManager* sharedManagerIfExists(); WEBCORE_EXPORT static PlatformMediaSessionManager& sharedManager(); static void updateNowPlayingInfoIfNecessary(); WEBCORE_EXPORT static void setShouldDeactivateAudioSession(bool); WEBCORE_EXPORT static bool shouldDeactivateAudioSession(); WEBCORE_EXPORT static void setWebMFormatReaderEnabled(bool); WEBCORE_EXPORT static bool webMFormatReaderEnabled(); WEBCORE_EXPORT static void setVorbisDecoderEnabled(bool); WEBCORE_EXPORT static bool vorbisDecoderEnabled(); WEBCORE_EXPORT static void setOpusDecoderEnabled(bool); WEBCORE_EXPORT static bool opusDecoderEnabled(); #if ENABLE(VP9) WEBCORE_EXPORT static void setShouldEnableVP9Decoder(bool); WEBCORE_EXPORT static bool shouldEnableVP9Decoder(); WEBCORE_EXPORT static void setShouldEnableVP8Decoder(bool); WEBCORE_EXPORT static bool shouldEnableVP8Decoder(); WEBCORE_EXPORT static void setShouldEnableVP9SWDecoder(bool); WEBCORE_EXPORT static bool shouldEnableVP9SWDecoder(); #endif virtual ~PlatformMediaSessionManager() = default; virtual void scheduleSessionStatusUpdate() { } bool has(PlatformMediaSession::MediaType) const; int count(PlatformMediaSession::MediaType) const; bool activeAudioSessionRequired() const; bool canProduceAudio() const; virtual bool hasActiveNowPlayingSession() const { return false; } virtual String lastUpdatedNowPlayingTitle() const { return emptyString(); } virtual double lastUpdatedNowPlayingDuration() const { return NAN; } virtual double lastUpdatedNowPlayingElapsedTime() const { return NAN; } virtual MediaUniqueIdentifier lastUpdatedNowPlayingInfoUniqueIdentifier() const { return { }; } virtual bool registeredAsNowPlayingApplication() const { return false; } virtual bool haveEverRegisteredAsNowPlayingApplication() const { return false; } virtual void prepareToSendUserMediaPermissionRequest() { } bool willIgnoreSystemInterruptions() const { return m_willIgnoreSystemInterruptions; } void setWillIgnoreSystemInterruptions(bool ignore) { m_willIgnoreSystemInterruptions = ignore; } WEBCORE_EXPORT virtual void beginInterruption(PlatformMediaSession::InterruptionType); WEBCORE_EXPORT void endInterruption(PlatformMediaSession::EndInterruptionFlags); WEBCORE_EXPORT void applicationWillBecomeInactive(); WEBCORE_EXPORT void applicationDidBecomeActive(); WEBCORE_EXPORT void applicationWillEnterForeground(bool suspendedUnderLock); WEBCORE_EXPORT void applicationDidEnterBackground(bool suspendedUnderLock); WEBCORE_EXPORT void processWillSuspend(); WEBCORE_EXPORT void processDidResume(); bool mediaPlaybackIsPaused(MediaSessionGroupIdentifier); void pauseAllMediaPlaybackForGroup(MediaSessionGroupIdentifier); WEBCORE_EXPORT void stopAllMediaPlaybackForProcess(); void suspendAllMediaPlaybackForGroup(MediaSessionGroupIdentifier); void resumeAllMediaPlaybackForGroup(MediaSessionGroupIdentifier); void suspendAllMediaBufferingForGroup(MediaSessionGroupIdentifier); void resumeAllMediaBufferingForGroup(MediaSessionGroupIdentifier); enum SessionRestrictionFlags { NoRestrictions = 0, ConcurrentPlaybackNotPermitted = 1 << 0, BackgroundProcessPlaybackRestricted = 1 << 1, BackgroundTabPlaybackRestricted = 1 << 2, InterruptedPlaybackNotPermitted = 1 << 3, InactiveProcessPlaybackRestricted = 1 << 4, SuspendedUnderLockPlaybackRestricted = 1 << 5, }; typedef unsigned SessionRestrictions; WEBCORE_EXPORT void addRestriction(PlatformMediaSession::MediaType, SessionRestrictions); WEBCORE_EXPORT void removeRestriction(PlatformMediaSession::MediaType, SessionRestrictions); WEBCORE_EXPORT SessionRestrictions restrictions(PlatformMediaSession::MediaType); virtual void resetRestrictions(); virtual bool sessionWillBeginPlayback(PlatformMediaSession&); virtual void sessionWillEndPlayback(PlatformMediaSession&, DelayCallingUpdateNowPlaying); virtual void sessionStateChanged(PlatformMediaSession&); virtual void sessionDidEndRemoteScrubbing(PlatformMediaSession&) { }; virtual void clientCharacteristicsChanged(PlatformMediaSession&) { } virtual void sessionCanProduceAudioChanged(); #if PLATFORM(IOS_FAMILY) virtual void configureWireLessTargetMonitoring() { } #endif virtual bool hasWirelessTargetsAvailable() { return false; } virtual void setCurrentSession(PlatformMediaSession&); PlatformMediaSession* currentSession() const; void sessionIsPlayingToWirelessPlaybackTargetChanged(PlatformMediaSession&); WEBCORE_EXPORT void setIsPlayingToAutomotiveHeadUnit(bool); bool isPlayingToAutomotiveHeadUnit() const { return m_isPlayingToAutomotiveHeadUnit; } void forEachMatchingSession(const Function& predicate, const Function& matchingCallback); bool processIsSuspended() const { return m_processIsSuspended; } WEBCORE_EXPORT void addAudioCaptureSource(PlatformMediaSession::AudioCaptureSource&); WEBCORE_EXPORT void removeAudioCaptureSource(PlatformMediaSession::AudioCaptureSource&); bool hasAudioCaptureSource(PlatformMediaSession::AudioCaptureSource& source) const { return m_audioCaptureSources.contains(source); } WEBCORE_EXPORT void processDidReceiveRemoteControlCommand(PlatformMediaSession::RemoteControlCommandType, const PlatformMediaSession::RemoteCommandArgument&); bool isInterrupted() const { return m_interrupted; } bool hasNoSession() const; virtual void addSupportedCommand(PlatformMediaSession::RemoteControlCommandType) { }; virtual void removeSupportedCommand(PlatformMediaSession::RemoteControlCommandType) { }; virtual RemoteCommandListener::RemoteCommandsSet supportedCommands() const { return { }; }; WEBCORE_EXPORT void processSystemWillSleep(); WEBCORE_EXPORT void processSystemDidWake(); virtual void resetHaveEverRegisteredAsNowPlayingApplicationForTesting() { }; protected: friend class PlatformMediaSession; static std::unique_ptr create(); PlatformMediaSessionManager(); virtual void addSession(PlatformMediaSession&); virtual void removeSession(PlatformMediaSession&); void forEachSession(const Function&); void forEachSessionInGroup(MediaSessionGroupIdentifier, const Function&); bool anyOfSessions(const Function&) const; bool isApplicationInBackground() const { return m_isApplicationInBackground; } void maybeDeactivateAudioSession(); bool maybeActivateAudioSession(); #if !RELEASE_LOG_DISABLED const Logger& logger() const final { return m_logger; } const void* logIdentifier() const final { return nullptr; } const char* logClassName() const override { return "PlatformMediaSessionManager"; } WTFLogChannel& logChannel() const final; #endif int countActiveAudioCaptureSources(); bool computeSupportsSeeking() const; private: friend class Internals; void scheduleUpdateSessionState(); virtual void updateSessionState() { } Vector> sessionsMatching(const Function&) const; SessionRestrictions m_restrictions[static_cast(PlatformMediaSession::MediaType::WebAudio) + 1]; mutable Vector> m_sessions; bool m_interrupted { false }; mutable bool m_isApplicationInBackground { false }; bool m_willIgnoreSystemInterruptions { false }; bool m_processIsSuspended { false }; bool m_isPlayingToAutomotiveHeadUnit { false }; #if USE(AUDIO_SESSION) bool m_becameActive { false }; #endif WeakHashSet m_audioCaptureSources; bool m_hasScheduledSessionStateUpdate { false }; #if ENABLE(WEBM_FORMAT_READER) static bool m_webMFormatReaderEnabled; #endif #if ENABLE(VORBIS) && PLATFORM(MAC) static bool m_vorbisDecoderEnabled; #endif #if ENABLE(OPUS) && PLATFORM(MAC) static bool m_opusDecoderEnabled; #endif #if ENABLE(VP9) static bool m_vp9DecoderEnabled; static bool m_vp8DecoderEnabled; static bool m_vp9SWDecoderEnabled; #endif #if !RELEASE_LOG_DISABLED Ref m_logger; #endif }; } #endif // PlatformMediaSessionManager_h