dbus media http api

API HTTP DBUS MRIS MediaPlayer

Cette API HTTP se connecte aux DBU de l'hôte pour récupérer les informations médiatiques actuelles. Il expose un point de terminaison où ces informations sont accessibles et diverses méthodes peuvent être exécutées.

Points de terminaison

GET /get Returns a list of all available Mris MediaPlayer2 objects.

Réponse

{
  "error" : false ,
  "result" : [
    {
      "service" : " org.mpris.MediaPlayer2.APPLICATION " ,
      "mpris:artUrl" : " BASE64 DATA " ,
      "mpris:length" : 1230 ,
      "mpris:trackid" : " TRACK ID " ,
      "playback_status" : " Playing " ,
      "position" : 1230 ,
      "volume" : 1 ,
      "xesam:album" : " " ,
      "xesam:artist" : [
        " ARTIST "
      ],
      "xesam:title" : " TITLE "
    }
  ]
}

GET /{action}/{service} Triggers a specified action in the provided service.

Actions valides:

• playpause
• play
• pause
• stop
• next
• previous

Réponse

{ "error" : false , "message" : " ACTION executed successfully " }

Note

Si vous avez AUTH=true et AUTH_KEY=KEY set dans votre fichier .env, vous devrez ajouter un en-tête Authorization avec la clé d'authentification de vos demandes.

Usage

Pour exécuter cette API HTTP, vous avez besoin d'une machine Linux avec DBUS installée. Ce projet s'intègre à l'interaction DBUS MRIS Média pour l'interaction des lecteurs multimédias. Vous devrez également compiler ce projet.

Pour compiler et exécuter ce projet, suivez ces commandes:

git clone https://github.com/Towsif12/dbus-media-http-api.git
cd dbus-media-http-api

go build -o dbus-media-api ./src
chmod +x dbus-media-api

./dbus-media-api

Facultativement, vous pouvez utiliser un fichier .env pour configurer la clé du port, de l'authentification et de l'authentification:

 PORT=10004
AUTH=true
AUTH_KEY=key123

Développement

Le processus de développement est similaire aux instructions d'utilisation. Commencez par cloner le référentiel, puis vous pouvez modifier le code dans le répertoire src/ .

Pour exécuter le projet pendant le développement, utilisez la commande suivante:

go run ./src

N'hésitez pas à soumettre une demande de traction (PR) ou à publier un problème si vous rencontrez des bogues ou des erreurs.

Sources

Ces liens étaient des ressources utiles tout au long du développement de ce projet:

• https://www.baeldung.com/linux/dbus
• https://github.com/godbus/dbus/
• https://github.com/joho/godotenv
• https://tutorialedge.net/golang/creating-restful-api-with-golang/
• https://specifications.freedesktop.org/mpris-spec/2.2/player_interface.html