Apêndice B. A Interface de D-Bus

Índice

Exemplos de D-Bus
API de D-Bus
Abrir um ficheiro ou pasta
Descarrega as marcas de todos os ficheiros que não estejam modificados ou seleccionados
Grava todos os ficheiros modificados
Obtém uma mensagem de erro detalhada oferecida por alguns dos métodos
Reverte as modificações nos ficheiros seleccionados
Inicia uma importação automática em lote
Importar as marcas de um ficheiro
Importar as marcas de outras marcas
Imptrar as marcas de outras marcas nos ficheiros seleccionados
Obter as imagens da capa do álbum
Exportar as marcas para um ficheiro
Criar uma lista de reprodução
Obter os itens de uma lista de reprodução
Define os itens de uma lista de reprodução
Sair da aplicação
Seleccionar todos os ficheiros
Deseleccionar todos os ficheiros
Configura o primeiro ficheiro como o ficheiro actual
Configura o ficheiro anterior como sendo o actual
Configura o ficheiro seguinte como sendo o actual
Selecciona o primeiro ficheiro
Seleccionar o ficheiro anterior
Seleccionar o ficheiro seguinte
Seleccionar o ficheiro actual
Expande ou fecha o item do ficheiro actual se for uma pasta
Aplicar o formato de nomes dos ficheiros
Aplicar o formato das marcas
Aplicar a codificação do texto
Definir o nome da pasta a partir das marcas
Define os números das faixas subsequentes nos ficheiros seleccionados
Filtrar os ficheiros
Converter as marcas de ID3v2.3 para ID3v2.4
Converter as marcas de ID3v2.4 para ID3v2.3
Obter a localização da pasta
Obtém o nome do ficheiro actual
Define o nome do ficheiro seleccionado
Define o formato a usar quando definir o nome do ficheiro a partir das marcas
Configura os nomes dos ficheiros para os ficheiros seleccionados a partir das marcas
Obter o valor do pacote
Configurar o valor do pacote
Obter todos os pacotes de uma marca
Obter informações técnicas sobre o ficheiro
Configurar uma marca a partir do nome do ficheiro
Configurar uma marca a partir de outra marca
Copiar a marca
Colar a marca
Remover a marca
Volta a processar a configuração
Reproduz os ficheiros seleccionados

Exemplos de D-Bus

No Linux®, poderá usar uma interface do D-Bus para controlar o Kid3 através de programas. Os programas poderão ser criados em qualquer linguagem que tenha interfaces para o D-Bus (p.ex. em Python) e podem ser adicionadas às Acções do Utilizador para estender a funcionalidade do Kid3.

O artista na marca 2 do ficheiro actual poderá ser configurado com o valor "Famoso Desconhecido" com o seguinte código:

Linha de comandos
dbus-send --dest=org.kde.kid3 --print-reply=literal \
/Kid3 org.kde.Kid3.setFrame int32:2 string:'Artist' \
string:'Famoso Desconhecido'

ou ainda mais facilmente com o qdbus do Qt™ (o qdbusviewer pode ser usado para explorar a interface numa GUI):

qdbus org.kde.kid3 /Kid3 setFrame 2 Artist \
'Famoso Desconhecido'
Python
import dbus
kid3 = dbus.SessionBus().get_object(
  'org.kde.kid3', '/Kid3')
kid3.setFrame(2, 'Artist', 'Famoso Desconhecido')
Perl
use Net::DBus;
$kid3 = Net::DBus->session->get_service(
  "org.kde.kid3")->get_object(
  "/Kid3", "org.kde.Kid3");
$kid3->setFrame(2, "Artist", "Famoso Desconhecido");