widget/gtk/MPRISServiceHandler.h

   1 /* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 2 -*-
   2  *
   3  * This Source Code Form is subject to the terms of the Mozilla Public
   4  * License, v. 2.0. If a copy of the MPL was not distributed with this
   5  * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
   6
   7 #ifndef WIDGET_GTK_MPRIS_SERVICE_HANDLER_H_
   8 #define WIDGET_GTK_MPRIS_SERVICE_HANDLER_H_
   9
  10 #include <gio/gio.h>
  11 #include "mozilla/dom/FetchImageHelper.h"
  12 #include "mozilla/dom/MediaControlKeySource.h"
  13 #include "mozilla/Attributes.h"
  14 #include "mozilla/UniquePtr.h"
  15 #include "nsIFile.h"
  16 #include "nsMimeTypes.h"
  17 #include "nsString.h"
  18
  19 #define DBUS_MPRIS_SERVICE_NAME "org.mpris.MediaPlayer2.firefox"
  20 #define DBUS_MPRIS_OBJECT_PATH "/org/mpris/MediaPlayer2"
  21 #define DBUS_MPRIS_INTERFACE "org.mpris.MediaPlayer2"
  22 #define DBUS_MPRIS_PLAYER_INTERFACE "org.mpris.MediaPlayer2.Player"
  23 #define DBUS_MPRIS_TRACK_PATH "/org/mpris/MediaPlayer2/firefox"
  24
  25 namespace mozilla {
  26 namespace widget {
  27
  28 /**
  29  * This class implements the "MPRIS" D-Bus Service
  30  * (https://specifications.freedesktop.org/mpris-spec/2.2),
  31  * which is used to communicate with the Desktop Environment about the
  32  * Multimedia playing in Gecko.
  33  * Note that this interface requires many methods which may not be supported by
  34  * Gecko, the interface
  35  * however provides CanXYZ properties for these methods, so the method is
  36  * defined but won't be executed.
  37  *
  38  * Also note that the following defines are for parts that the MPRIS Spec
  39  * defines optional. The code won't
  40  * compile with any of the defines set, yet, as those aren't implemented yet and
  41  * probably never will be of
  42  * use for gecko. For sake of completeness, they have been added until the
  43  * decision about their implementation
  44  * is finally made.
  45  *
  46  * The constexpr'ed methods are capabilities of the user agent known at compile
  47  * time, e.g. we decided at
  48  * compile time whether we ever want to support closing the user agent via MPRIS
  49  * (Quit() and CanQuit()).
  50  *
  51  * Other properties like CanPlay() might depend on the runtime state (is there
  52  * media available for playback?)
  53  * and thus aren't a constexpr but merely a const method.
  54  */
  55 class MPRISServiceHandler final : public dom::MediaControlKeySource {
  56   NS_INLINE_DECL_REFCOUNTING(MPRISServiceHandler, override)
  57  public:
  58   // Note that this constructor does NOT initialize the MPRIS Service but only
  59   // this class. The method Open() is responsible for registering and MAY FAIL.
  60
  61   MPRISServiceHandler();
  62   bool Open() override;
  63   void Close() override;
  64   bool IsOpened() const override;
  65
  66   // From the EventSource.
  67   void SetPlaybackState(dom::MediaSessionPlaybackState aState) override;
  68
  69   // GetPlaybackState returns dom::PlaybackState. GetPlaybackStatus returns this
  70   // state converted into d-bus variants.
  71   GVariant* GetPlaybackStatus() const;
  72
  73   const char* Identity() const;
  74   const char* DesktopEntry() const;
  75   bool PressKey(dom::MediaControlKey aKey) const;
  76
  77   void SetMediaMetadata(const dom::MediaMetadataBase& aMetadata) override;
  78   GVariant* GetMetadataAsGVariant() const;
  79
  80   void SetSupportedMediaKeys(const MediaKeysArray& aSupportedKeys) override;
  81
  82   bool IsMediaKeySupported(dom::MediaControlKey aKey) const;
  83
  84  private:
  85   ~MPRISServiceHandler();
  86
  87   // Note: Registration Ids for the D-Bus start with 1, so a value of 0
  88   // indicates an error (or an object which wasn't initialized yet)
  89
  90   // a handle to our bus registration/ownership
  91   guint mOwnerId = 0;
  92   // This is for the interface org.mpris.MediaPlayer2
  93   guint mRootRegistrationId = 0;
  94   // This is for the interface org.mpris.MediaPlayer2.Player
  95   guint mPlayerRegistrationId = 0;
  96   RefPtr<GDBusNodeInfo> mIntrospectionData;
  97   GDBusConnection* mConnection = nullptr;
  98   bool mInitialized = false;
  99   nsAutoCString mIdentity;
 100   nsAutoCString mDesktopEntry;
 101
 102   // The image format used in MPRIS is based on the mMimeType here. Although
 103   // IMAGE_JPEG or IMAGE_BMP are valid types as well but a png image with
 104   // transparent background will be converted into a jpeg/bmp file with a
 105   // colored background IMAGE_PNG format seems to be the best choice for now.
 106   nsCString mMimeType{IMAGE_PNG};
 107
 108   // A bitmask indicating what keys are enabled
 109   uint32_t mSupportedKeys = 0;
 110
 111   class MPRISMetadata : public dom::MediaMetadataBase {
 112    public:
 113     MPRISMetadata() = default;
 114     ~MPRISMetadata() = default;
 115
 116     void UpdateFromMetadataBase(const dom::MediaMetadataBase& aMetadata) {
 117       mTitle = aMetadata.mTitle;
 118       mArtist = aMetadata.mArtist;
 119       mAlbum = aMetadata.mAlbum;
 120       mArtwork = aMetadata.mArtwork;
 121     }
 122     void Clear() {
 123       UpdateFromMetadataBase(MediaMetadataBase::EmptyData());
 124       mArtUrl.Truncate();
 125     }
 126
 127     nsCString mArtUrl;
 128   };
 129   MPRISMetadata mMPRISMetadata;
 130
 131   // The saved image file fetched from the URL
 132   nsCOMPtr<nsIFile> mLocalImageFile;
 133   nsCOMPtr<nsIFile> mLocalImageFolder;
 134
 135   UniquePtr<dom::FetchImageHelper> mImageFetcher;
 136   MozPromiseRequestHolder<dom::ImagePromise> mImageFetchRequest;
 137
 138   nsString mFetchingUrl;
 139   nsString mCurrentImageUrl;
 140
 141   size_t mNextImageIndex = 0;
 142
 143   // Load the image at index aIndex of the metadta's artwork to MPRIS
 144   // asynchronously
 145   void LoadImageAtIndex(const size_t aIndex);
 146   bool SetImageToDisplay(const char* aImageData, uint32_t aDataSize);
 147
 148   bool RenewLocalImageFile(const char* aImageData, uint32_t aDataSize);
 149   bool InitLocalImageFile();
 150   bool InitLocalImageFolder();
 151   void RemoveAllLocalImages();
 152   bool LocalImageFolderExists();
 153
 154   // Queries nsAppInfo to get the branded browser name and vendor
 155   void InitIdentity();
 156
 157   // non-public API, called from events
 158   void OnNameAcquired(GDBusConnection* aConnection, const gchar* aName);
 159   void OnNameLost(GDBusConnection* aConnection, const gchar* aName);
 160   void OnBusAcquired(GDBusConnection* aConnection, const gchar* aName);
 161
 162   static void OnNameAcquiredStatic(GDBusConnection* aConnection,
 163                                    const gchar* aName, gpointer aUserData);
 164   static void OnNameLostStatic(GDBusConnection* aConnection, const gchar* aName,
 165                                gpointer aUserData);
 166   static void OnBusAcquiredStatic(GDBusConnection* aConnection,
 167                                   const gchar* aName, gpointer aUserData);
 168
 169   void EmitEvent(dom::MediaControlKey aKey) const;
 170
 171   bool EmitMetadataChanged() const;
 172
 173   void SetMediaMetadataInternal(const dom::MediaMetadataBase& aMetadata,
 174                                 bool aClearArtUrl = true);
 175
 176   bool EmitSupportedKeyChanged(dom::MediaControlKey aKey,
 177                                bool aSupported) const;
 178
 179   bool EmitPropertiesChangedSignal(GVariant* aParameters) const;
 180
 181   void ClearMetadata();
 182 };
 183
 184 }  // namespace widget
 185 }  // namespace mozilla
 186
 187 #endif  // WIDGET_GTK_MPRIS_SERVICE_HANDLER_H_