dbus media http api

DBUS MRIS MediaPlayer HTTP API

Esta API HTTP se conecta ao DBUS do host para recuperar informações atuais da mídia. Ele expõe um terminal em que essas informações podem ser acessadas e vários métodos podem ser executados.

Pontos de extremidade

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

Resposta

{
  "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.

Ações válidas:

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

Resposta

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

Observação

Se você tiver AUTH=true e AUTH_KEY=KEY definida no seu arquivo .env, precisará adicionar um cabeçalho Authorization com a chave de autenticação às suas solicitações.

Uso

Para executar esta API HTTP, você precisa de uma máquina Linux com DBUS instalado. Este projeto se integra ao DBUS MRIS Media Player para a interação do Media Player. Você também precisará compilar este projeto.

Para compilar e executar este projeto, siga estes comandos:

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

Opcionalmente, você pode usar um arquivo .env para configurar a chave da porta, autenticação e autenticação:

 PORT=10004
AUTH=true
AUTH_KEY=key123

Desenvolvimento

O processo de desenvolvimento é semelhante às instruções de uso. Comece clonando o repositório e, em seguida, você pode modificar o código no diretório src/ .

Para executar o projeto durante o desenvolvimento, use o seguinte comando:

go run ./src

Sinta -se à vontade para enviar uma solicitação de tração (PR) ou postar um problema se encontrar bugs ou erros.

Fontes

Esses links foram recursos úteis durante todo o desenvolvimento deste projeto:

• 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