# Configurazione controllo a distanza a infrarossi di &kde;

Frank
Scheffold

    fscheffold@googlemail.com

Michael
Zanetti

    michael_zanetti@gmx.net

Gav
Wood

    gav@kde.org

Massimiliano
Donno

    massidonno@infinito.it

Traduzione della documentazione
Luigi
Toscano

    luigi.toscano@tiscali.it

Traduzione della documentazione
2010-01-06
2.0
2004
Gav Wood
2010
Frank Scheffold
Michael Zanetti

Configurazione di &kdelirc;: l'infrastruttura per le funzionalità di controllo remoto di &kde; tramite infrarossi.

KDE
irkick
kdelirc
kcmlirc
lirc

## Introduzione

### Requisiti

Per usare l'infrastruttura &kdelirc; devi aver impostato LIRC sul tuo computer. Se è correttamente impostato, l'icona di &kdelirc; nel vassoio di sistema si colorerà di rosso . Se no, sarà disattivato (in grigio) e barrato .

Per maggiori informazioni su LIRC e su come configurarlo, visita il loro sito web http://www.lirc.org.

Nota: quando si configura LIRC, si consiglia di usare i namespace per i pulsanti.

## Uso

Ci sono tre schede che presentano varie sezione di configurazione e ulteriori informazioni. La prima scheda, chiamata Funzioni controller, è usata per configurare le modalità e le azioni per tutti i telecomandi disponibili. La scheda chiamata Panoramica profili contiene dettagli sui profili disponibili. La scheda Telecomandi disponibili mostra ulteriori informazioni sui tuoi telecomandi. Selezionando un telecomando è possibile vedere una panoramica dei suoi pulsanti.

### Funzioni controller

#### Telecomandi e modalità

Ogni telecomando può avere un certo numero di modalità di funzionamento. La presenza di diverse modalità permette allo stesso pulsante di effettuare diverse azioni in differenti situazioni.Pensa ad esso come ad un telecomando multifunzione TV/Video/Satellite/DVD. Invece di usare diversi telecomandi per diverse applicazioni, puoi cambiare il comportamento di un telecomando perché si adatti a varie applicazioni creando diversi modalità, e commutando tra di esse se necessario.

Le azioni definite direttamente per il telecomando sono sempre disponibili, indipendentemente dall'attuale modalità del telecomando. Le azioni definite per una specifica modalità sono eseguite solo se il telecomando è impostato in tale modalità. Ogni telecomando può essere solo in una modalità alla volta. Può anche non essere in nessuna modalità, e questo significa che solo le azioni sempre disponibili saranno eseguite in seguito alla pressione dei pulsanti. Puoi anche definire una modalità predefinita, che è quella attivata automaticamente all'avvio.

La lista a sinistra contiene tutti i telecomandi rilevati sul sistema. Modalità possono essere aggiunte o rimosse selezionando il telecomando o la modalità desiderata e utilizzando i pulsanti sotto lo lista. Il pulsante Modifica permette di modificare le modalità esistenti.

#### Assegnazione di azioni ai pulsanti

&kdelirc; conosce due diversi tipi di azioni: cambi di modalità e azioni da eseguire. I cambi di modalità consentono di cambiare la modalità dell'attuale telecomando, mentre le normali azioni consentono l'esecuzione di comandi tramite &DBus;. Quando definisci una nuova azione eseguibile hai due possibilità. La prima consiste nell'usare un modello, mentre la seconda richiede di indicare manualmente tutte le possibili opzioni. I modelli per le azioni sono chiamati profili. Anche se l'uso dei profili per la creazione di azioni è più semplice e immediato, con i profili non è possibile accedere a tutte le funzionalità. Le azioni più avanzate possono essere configurate selezionando manualmente le funzioni e i loro parametri.

Per aggiungere un'azione usa il pulsante Aggiungi... in basso a destra. Inizierà una procedura guidata che ti chiederà quale tipo di azione debba essere creata. La prima opzione creerà un'azione a partire da un profilo. La seconda opzione ti consente di creare manualmente l'intera azione. Ricorda che l'applicazione che vuoi controllare deve essere in esecuzione quando configuri l'azione, o non comparirà nella lista delle applicazioni disponibili. La terza opzione consente di creare un'azione di cambio di modalità. Seleziona il tipo di azione che desideri e segui i passi della procedura guidata.

Le azioni possono essere assegnate automaticamente tramite il pulsante Assegna automaticamente.... Questo vuol dire che &kdelirc; può cercare di associare per te i pulsanti alle azioni. La finestra di dialogo di assegnazione automatica mostra tutti i profili disponibili con una bandiera associata. Il colore della bandiera indica se il tuo telecomando è pienamente, parzialmente o non supportato da quel profilo. Verde vuol dire supporto pieno; giallo, parziale; rosso, nessun supporto.

Nota: se il tuo telecomando non è compatibile con nessun profilo potresti non aver configurato lirc per usare i namespace.

### Panoramica profili

La scheda Panoramica profili fornisce informazioni sui profili disponibili. Selezionando un profilo puoi vedere informazioni dettagliate come i dettagli dell'autore e un elenco di tutte le azioni definite. Ogni voce relativa ad un'azione contiene informazioni su ulteriori impostazioni, un commento e l'identificativo del pulsante da usare per la funzione di assegnazione automatica.

Se vuoi contribuire alla creazione di profili di applicazioni, consulta il capitolo informazioni avanzate.

### Telecomandi disponibili

Questa scheda fornisce tutte le informazioni dettagliati sui telecomandi. Puoi controllare qui se i tuoi telecomandi sono stati riconosciuti correttamente dal sistema.

## Informazioni avanzate

Questo capitolo illustra alcune informazioni che potrebbero essere interessanti per gli utenti più avanzati e per gli sviluppatori. Imparerai come creare dei profili.

### Creazione di profili

#### Introduzione

Tutte i programmi con supporto &DBus; possono essere usati con &kdelirc; senza bisogno di modifiche. Tuttavia, per fornire una configurazione più semplice da usare per gli utenti e fare sì che un'applicazione compaia nella finestra di dialogo di assegnazione automatica, potresti creare un profilo per essa.

Un profilo indica a &kdelirc; (e all'utente!) cosa fanno le varie chiamate &DBus;. Si tratta essenzialmente di un tipo di documentazione per le chiamate &DBus;. Non devi includere tutte le chiamate &DBus; - solo quelle che reputi possano essere maggiormente utili per gli utenti finali (normalmente le chiamate relative alla modifica dell'interfaccia, piuttosto che quelle per la raccolta di informazioni).

#### Creazione

1. ##### &DBus;

   Assicurati che l'applicazione per cui vuoi creare un profilo fornisca delle funzioni su &DBus;. Puoi controllare questo cercando di aggiungere delle azioni per quell'applicazione usando il metodo manuale in &kdelirc;. Anche il programma qdbusviewer, compreso nell'installazione di Qt4, è un'ottimo strumento per determinare le funzionalità &DBus; di un'applicazione.

2. ##### Creazione di un profilo

   Una volta che hai trovato le funzioni &DBus; appropriate, devi descriverle in un documento `nomeapplicazione.profile.xml`. Di seguito, una piccola guida per creare tali file:

   1. Per prima cosa crea un nuovo file con il seguente contenuto. Sostituisci mioprogramma con il nome dell'eseguibile dell'applicazione e Il mio programma con la descrizione dell'applicazione.

          <?xml version="1.0" ?>
          <!DOCTYPE profile SYSTEM "profile.dtd">

            <profile id="mioprogramma" servicename="Il mio programma">
            </profile>

   2. All'interno del marcatore profile aggiungi il nome e le informazioni sull'autore. Il marcatore instances informa &kdelirc; sul fatto che l'applicazione possa essere eseguita più volte o meno. Imposta unique a 0 se vuoi avviare l'applicazione più volte (il valore predefinito è 1). La proprietà ifmulti specifica cosa deve fare &kdelirc; se ci sono più istanze in esecuzione quando viene premuto un pulsante. Le opzioni sono dontsend (non fare nulla se le istanze sono > 1), sendtoone (esegui la chiamata su un'istanza scelta in modo arbitrario) e sendtoall (invia a tutte le istanze). Il valore predefinito è dontsend, anche se sendtone potrebbe essere più utile in molti casi.

          <?xml version="1.0" ?>
          <!DOCTYPE profile SYSTEM "profile.dtd">

            <profile id="mioprogramma" servicename="Il mio programma">
              <name>Il mio programma</name>
              <author>Io</author>
              <instances unique="0" ifmulti="sendtoone"/>
            </profile>

   3. Riempi il profilo inserendo dei marcatori di azione. Ogni marcatore di azione deve contenere il nome dell'oggetto &DBus; e il prototipo della funzione.

      &kdelirc; ha bisogno di alcuni attributi supplementari per sapere come gestire un'azione. Il marcatore button è usato per la funzione di assegnazione automatica. Controlla la documentazione delle API di Solid per avere la lista completa dei nomi di pulsanti disponibili. Il marcatore repeat indica se l'azione debba essere eseguita più volte se il pulsante del telecomando viene mantenuto premuto (0 = no, 1 = sì). Il marcatore autostart definisce se l'applicazione debba essere avviata nel caso in cui non fosse già in esecuzione.

          <?xml version="1.0" ?>
          <!DOCTYPE profile SYSTEM "profile.dtd">

            <profile id="mioprogramma" servicename="Il mio programma">
              <name>Il mio programma</name>
              <author>Io</author>
              <instances unique="0" ifmulti="sendtoone"/>
              <action objid="MioProgr" prototype="void showint(short int)"
                button="Menu" repeat="0" autostart="0">
              </action>
            </profile>

   4. Aggiungi un nome ed un commento per l'azione. Questi vengono mostrati nell'interfaccia di &kdelirc;.

          <?xml version="1.0" ?>
          <!DOCTYPE profile SYSTEM "profile.dtd">

            <profile id="mioprogramma" servicename="Il mio programma">
              <name>Il mio programma</name>
              <author>Io</author>
              <instances unique="0" ifmulti="sendtoone"/>
              <action objid="MioProgr" prototype="void showint(short int)"
                button="Menu" repeat="0" autostart="0">
                <name>Mostra interi</name>
                <comment>Mostra un valore intero configurabile</comment>
              </action>
            </profile>

   5. Descrivi ogni argomento con un commento ed un attributo di tipo. Una lista di tipi validi può essere reperita nel file di descrizione dei profili. Devi dichiarare un valore predefinito per ogni argomento tra i marcatori default:

          <?xml version="1.0" ?>
          <!DOCTYPE profile SYSTEM "profile.dtd">

            <profile id="mioprogramma" servicename="Il mio programma">
              <name>Il mio programma</name>
              <author>Io</author>
              <instances unique="0" ifmulti="sendtoone"/>
              <action objid="MioProgr" prototype="void showint(short int)"
                button="Menu" repeat="0" autostart="0">
                <name>Mostra interi</name>
                <comment>Mostra un valore intero configurabile</comment>
                <argument type="int">
                  <default>5</default>
                  <comment>Il valore intero da mostrare</comment>
                </argument>
              </action>
            </profile>

#### Installazione

Per provare ed usare il profilo, lo devi copiare in `$(kde_datadir)/profiles` e riavviare &kdelirc;.

Se desideri rendere disponibile il profilo con &kde; SC, invialo alla squadra di sviluppo di kdeutils su kde-utils-devel@kde.org.