# Configurazione dei telecomandi di &kde;

## Introduzione

Questo modulo permette di configurare i telecomandi. Puoi assegnare azioni eseguite alla pressione dei pulsanti. Le azioni possono avviare applicazioni, controllarle o eseguire dei comandi di sistema, come spegnere il computer.

### Requisiti

Per usare TeleKomando devi aver configurato un motore per telecomandi sul computer. Attualmente ce n'è disponibile uno solo, per LIRC. Se LIRC è impostato correttamente, l'icona di TeleKomando nel vassoio di sistema si colorerà di rosso . Altrimenti, sarà grigia e con una croce sopra .

Per maggiori informazioni su LIRC visita il loro sito Web.

## Uso

Il modulo di configurazione consiste di due elenchi. Quello a sinistra mostra i telecomandi disponibili e le loro modalità. L'elenco a destra mostra tutte le azioni configurate per il telecomando e la modalità attualmente selezionati. Configurazione di TeleKomando Elenco di telecomandi, modalità configurate e azioni

### Telecomandi e modalità

Ogni telecomando può avere una serie di diverse modalità. Avere più modalità permette ai pulsanti di eseguire azioni diverse in contesti diversi. Immaginalo come un telecomando multiuso per TV, videoregistratore, satellitare e DVD. Invece di usare telecomandi diversi per applicazioni diverse, puoi cambiare il comportamento di un telecomando per adattarsi a un'applicazione creando diverse modalità e cambiandole secondo necessità.Le azioni definite direttamente per il telecomando sono sempre disponibili, indipendentemente dalla sua presente modalità. Le azioni definite per una modalità specifica sono eseguite solo se il telecomando è impostato in tale modalità. Ogni telecomando può essere in una sola modalità alla volta. Può anche non essere in nessuna modalità, e questo significa che solo le azioni sempre disponibili saranno eseguite alla pressione dei pulsanti. Puoi anche definire una modalità predefinita, che è quella attivata automaticamente all'avvio.

Puoi aggiungere delle modalità a un telecomando selezionandolo e usando il pulsante + di fianco all'elenco. Quando si crea una modalità le si deve dare un nome. A scelta puoi assegnare un pulsante per attivarla e un'icona per le sue notifiche. Puoi eliminare le modalità selezionandole e usando il pulsante -. Aggiungi modalità Aggiungere una nuova modalità

Come impostazione predefinita, se ci sono più modalità con lo stesso pulsante assegnato, il pulsante viene usato per passare attraverso queste modalità. In questo modo puoi raggruppare le modalità. Per esempio potresti assegnare un pulsante col nome Musica per passare tra le modalità di &amarok; e &juk; mentre un pulsante di nome Video potrebbe passare tra le modalità di &dragon; o KMPlayer. Se preferissi avere un pulsante per passare attraverso tutte le modalità e un secondo per tornare a quella precedente, puoi impostare questo comportamento nelle preferenze dei telecomandi selezionandone uno e premendo il pulsante di modifica. Modifica telecomando Modificare un telecomando

### Azioni

Dopo aver selezionato un telecomando o una modalità, puoi aggiungerci delle azioni usando il pulsante + sulla destra. Ci sono due diversi modi in cui creare le azioni: usando un modello o sfogliando manualmente il bus della sessione di &DBus;. Aggiungere un'azione Aggiungere un'azione

Creare azioni con i modelli è più facile ma ha dei limiti. Puoi trovare i modelli per le applicazioni più comuni come &amarok; o l'avviatore di programmi di &kde; e i comandi di sistema per spegnere il computer. Questi modelli sono raccolti in profili che li raggruppano per compiti simili. Per esempi c'è un profilo chiamato Gestione energetica che contiene i modelli per spegnere o sospendere il computer. Azione per aggiungere profili Aggiungere un'azione con un modello

Creare azioni sfogliando D-Bus elenca tutte le applicazioni attualmente in esecuzione. Puoi sfogliare loro e le loro funzioni. Ciò richiede una comprensione di base del funzionamento di &DBus;, ma puoi usare più applicazioni e funzioni che quelle nell'elenco dei modelli. Azione di aggiunta con &DBus; Aggiungere un'azione con &DBus;

Quando si aggiunge un'azione la se ne possono modificare alcune opzioni. La prima di queste definisce se l'azione viene eseguita ripetutamente quando si tiene premuto il pulsante sul telecomando. Ciò è un comportamento utile per le azioni come aumentare o ridurre il volume, ma potrebbe non essere desiderato per le azioni come passare tra lettura e pausa in un lettore multimediale. La seconda definisce se l'applicazione di destinazione va avviata se non è in esecuzione alla pressione del pulsante. Per esempio, non avrebbe senso avviare un'applicazione per le azioni che la chiudono. La terza e ultima opzione è definire quale istanza dell'applicazione dovrebbe ricevere l'azione se ce ne sono diverse in esecuzione. Se hai selezionato un'applicazione che non può eseguire istanze multiple, questa opzione è disattivata.

Opzioni di aggiunta delle azioni Opzioni delle azioni

Le azioni possono anche essere assegnate automaticamente tramite il pulsante di assistenza. Ciò vuol dire che TeleKomando può cercare di associare i pulsanti alle azioni da sé. La finestra di assegnazione automatica mostra tutte le raccolte di modelli con una bandiera. A seconda del colore della bandiera, il telecomando è completamente, parzialmente o per niente supportato da quel profilo. Verde vuol dire che tutti i modelli contenuti possono essere fatti corrispondere al telecomando, giallo che alcune delle azioni contenute corrispondono, e rosso che nessuno dei modelli può essere fatto corrispondere ai pulsanti del telecomando. Puoi quindi solo configurarli uno per uno, impostando da te il pulsante desiderato. Assegnazione automatica Genera azioni automaticamente usando i modelli

Nota: se il telecomando non è compatibile con nessun profilo potresti non aver configurato LIRC con gli spazi di nomi.

## 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.

### Creare un profilo

#### Introduzione

Quasi tutti i programmi con supporto per &DBus; possono essere usati con TeleKomando senza bisogno di modifiche. Tuttavia, per permettere una facile configurazione e far comparire un'applicazione nella finestra di assegnazione automatica, potresti crearle un profilo.

Un profilo dice a TeleKomando (e all'utente!) cosa fanno le varie chiamate a &DBus;. Si tratta essenzialmente di un tipo di documentazione delle chiamate a &DBus;. Non le devi includere tutte, solo quelle che credi possano essere più utili per gli utenti finali (normalmente quelle relative alla regolazione dell'interfaccia, piuttosto che quelle per la raccolta di informazioni).

#### Guida ai profili

1. #### &DBus;

   Assicurati che l'applicazione per cui vuoi creare un profilo fornisca delle funzioni sul bus di sessione di &DBus;. Lo puoi verificare cercando di aggiungere delle azioni per quell'applicazione con il metodo manuale in TeleKomando. Anche qdbusviewer, un'applicazione inclusa nell'installazione di Qt4, è un buon strumento per determinare le funzionalità relative a &DBus; di un'applicazione.

2. #### Passo passo

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

   1. Prima, crea un nuovo file con il contenuto sottostante. Il tag name definisce un breve nome descrittivo del profilo. Aggiungi una descrizione del profilo nel tag description. Aggiungi inoltre il tuo nome nel tag author e un numero di versione nel tag version. Il numero di versione è importante per aggiornare il profilo. TeleKomando userà quello con il numero maggiore se ci sono più versioni del profilo sul sistema.

          <xml version="1.0" encoding="UTF-8"?>
          <profile xmlns="urn:org-kde-kremotecontrol"
            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
            xsi:schemaLocation="urn:org-kde-kremotecontrol file:profile.xsd">

              <name>Il mio profilo</name>
              <version>0.1</version>
              <author>Io</author>
              <description>Informazioni descrittive su cosa fa il profilo</description>
              <action>
                  <-- Questo tag sarà spiegato in seguito -->
              <action>

          </profile>

   2. Dopo aver creato lo scheletro del profilo, è ora di aggiungere dei modelli d'azione.

          <?xml version="1.0" encoding="UTF-8"?>
          <profile xmlns="urn:org-kde-kremotecontrol"
            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
            xsi:schemaLocation="urn:org-kde-kremotecontrol file:profile.xsd">

              <name>Il mio profilo</name>
              <version>0.1</version>
              <author>Io</author>
              <description>Informazioni descrittive su cosa fa il profilo</description>

              <action id="identificativoUnivoco"  repeat="true|false" button="unPulsante">
                <name>La mia azione</name>
                <description>Cosa fa l'azione</description>
                <prototype>
                  <-- Questo tag sarà spiegato in seguito -->
                <prototype>
                <ifmulti>Opzione ifMulti</ifmulti>
              </action>

          </profile>

      Per prima cosa definisci un identificativo univoco. Questo verrà usato da TeleKomando per far corrispondere le azioni esistenti al modello, per esempio leggendone la descrizione. Questo identificativo deve essere univoco in tutto il profilo. L'attributo button si usa per la funzione di assegnazione automatica. Vedi il file di schema profile.xsd per un elenco completo di tutti i nomi di pulsanti disponibili. L'attributo repeat indica se l'azione va eseguita più volte se il pulsante del telecomando viene tenuto premuto. Se l'applicazione va avviata se non è in esecuzione quando si preme un pulsante, imposta autostart a true. Gli attributi button, repeat e autostart sono facoltativi. Se repeat e autostart non sono definiti, saranno assunti essere impostati a false.

      Aggiungi un nome breve al tag name e una descrizione con il tag description. La proprietà ifmulti specifica cosa deve fare TeleKomando se ci sono più istanze in esecuzione alla pressione di un pulsante. Puoi usare i valori seguenti per questa proprietà: sendtotop (invia la chiamata all'istanza in cima alla pila delle finestre), sendtobottom (invia la chiamata all'istanza in fondo alla pila delle finestre), sendtoall (invia a tutte le istanze), dontsend (non inviare l'azione a nessuna istanza) e unique (questa applicazione non permette istanze multiple). Se questo tag non è definito, TeleKomando assumerà che le applicazioni non possono essere eseguite in istanze multiple, assegnando a questo tag il valore predefinito unique.

   3. Quindi, definisci la funzione di &DBus; da eseguire nel tag prototype:

          <?xml version="1.0" encoding="UTF-8"?>
          <profile xmlns="urn:org-kde-kremotecontrol"
            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
            xsi:schemaLocation="urn:org-kde-kremotecontrol file:profile.xsd">

              <name>Il mio profilo</name>
              <version>0.1</version>
              <author>Io</author>
              <description>Informazioni descrittive su cosa fa il profilo</description>

              <action id="identificativoUnivoco"  repeat="true|false" button="unPulsante">
                <name>La mia azione</name>
                <description>Cosa fa l'azione</description>

                <prototype>
                  <serviceName>org.esempio.applicazione</nomeServizio>
                  <node>Un/Nodo</node>
                  <function>funzione</function>
                </prototype>

                <ifmulti>Opzione ifMulti</ifmulti>
              </action>

          </profile>

      servicename contiene il nome del servizio &DBus; dell'applicazione, per esempio org.kde.plasma-desktop. node contiene il rispettivo nodo &DBus; come App. Aggiungi il nome della funzione senza il valore restituito e gli argomenti usando il tag function; per esempio, toggleDashboard.

   4. Se la funzione ha degli argomenti devi descriverli tutti, dandone una descrizione per l'utente, un tipo e a scelta un valore predefinito. Un elenco dei tipi supportati è disponibile nel file di schema profile.xsd. Il tag comment dovrebbe avere una descrizione comprensibile per l'utente dello scopo per cui si usa l'argomento. Dovresti anche dichiarare un valore predefinito per ogni argomento tra i tag default. Nota che i modelli che contengono un pulsante devono dare un valore predefinito per tutti gli argomenti, o la funzione di assegnazione automatica produrrà delle funzioni errate.

          <?xml version="1.0" encoding="UTF-8"?>
          <profile xmlns="urn:org-kde-kremotecontrol"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="urn:org-kde-kremotecontrol file:profile.xsd">

             <name>Il mio profilo</name>
              <version>0.1</version>
              <author>Io</author>
              <description>Informazioni descrittive su cosa fa il profilo</description>

              <action id="identificativoUnivoco"  repeat="true|false" button="unPulsante">
                <name>La mia azione</name>
                <description>Cosa fa l'azione</description>

                <prototype>
                  <serviceName>org.esempio.applicazione</nomeServizio>
                  <node>Un/Nodo</node>
                  <function>funzione</function>

                  <arguments>
                    <argument type="QString">
                      <comment>Commento aggiuntivo</comment>
                      <default>unValore</default>
                    </argument>
                  </arguments>

                </prototype>

                <ifmulti>Opzione ifMulti</ifmulti>
              </action>

          </profile>

#### Installazione

Per provare e usare il profilo lo devi copiare in `$(kde_datadir)/profiles` e riavviare TeleKomando.

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