Apèndix B. Interfície de D-Bus

Sumari

Exemples de D-Bus
API de D-Bus
Obrir un fitxer o carpeta
Descarregar les etiquetes de tots els fitxers que no han estat modificats o seleccionats
Desar tots els fitxers modificats
Obtenir un missatge d'error detallat proporcionat per alguns mètodes
Revertir els canvis fets als fitxers seleccionats
Iniciar automàticament una importació per lots
Importar etiquetes des d'un fitxer
Importar etiquetes des d'altres etiquetes
Importar etiquetes des d'altres etiquetes als fitxers seleccionats
Descarregar una caràtula de l'àlbum
Exportar les etiquetes a un fitxer
Crear una llista de reproducció
Obtenir els elements d'una llista de reproducció
Establir els elements d'una llista de reproducció
Surt de l'aplicació
Seleccionar tots els fitxers
Desseleccionar tots els fitxers
Establir el primer fitxer com a fitxer actual
Establir el fitxer anterior com a fitxer actual
Establir el següent fitxer com a fitxer actual
Selecciona el primer fitxer
Seleccionar el fitxer anterior
Seleccionar el següent fitxer
Seleccionar el fitxer actual
Expandir o contraure l'element de fitxer actual si es tracta d'una carpeta
Aplicar el format per al nom del fitxer
Aplicar el format per a les etiquetes
Aplicar la codificació del text
Establir el nom de la carpeta a partir de les etiquetes
Establir els números de peça subsegüents en els fitxers seleccionats
Filtratge de fitxers
Convertir entre les etiquetes ID3 versió 2.3 i 2.4
Convertir entre les etiquetes ID3 versió 2.4 i 2.3
Obtenir el camí de la carpeta
Obtenir el nom del fitxer actual
Establir el nom del fitxer seleccionat
Establir el format que s'utilitzarà en establir el nom del fitxer a partir de les etiquetes
Establir els noms de fitxer a partir dels fitxers seleccionats des de les etiquetes
Obtenir el valor del marc
Establir el valor del marc
Obtenir tots els marcs d'una etiqueta
Obtenir la informació tècnica sobre el fitxer
Establir l'etiqueta a partir del nom de fitxer
Establir l'etiqueta a partir d'una altra etiqueta
Copiar una etiqueta
Enganxar una etiqueta
Eliminar una etiqueta
Tornar a analitzar la configuració
Reproduir els fitxers seleccionats

Exemples de D-Bus

Al Linux®, es pot utilitzar una interfície de D-Bus per a controlar el Kid3 mitjançant scripts. Els scripts es poden escriure en qualsevol llenguatge amb vinculacions de D-Bus (p. ex., en Python) i es poden afegir a les Accions de l'usuari per a ampliar la funcionalitat del Kid3.

Es pot establir l'artista a l'etiqueta 2 del fitxer actual amb el valor «One Hit Wonder» amb el següent codi:

Intèrpret d'ordres
dbus-send --dest=org.kde.kid3 --print-reply=literal \
/Kid3 org.kde.Kid3.setFrame int32:2 string:'Artist' \
string:'Lluís Llach'

o més fàcil amb el qdbus de les Qt™ (es pot utilitzar el qdbusviewer per a explorar la interfície en una IGU):

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