<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
<!ENTITY kcmlirc "<application
>KDE LIRC Control Center Module</application
>">
<!ENTITY kdelirc "<application
>KDE LIRC</application
>">
<!ENTITY % Brazilian-Portuguese "INCLUDE"
> <!-- change language only here -->
<!ENTITY % addindex "IGNORE">
]>
<book lang="&language;">
<bookinfo>
<title
>Configuração do controle remoto por infravermelho do &kde;</title>
<authorgroup>
<author
><firstname
>Frank</firstname
> <surname
>Scheffold</surname
> <affiliation
> <address
><email
>fscheffold@googlemail.com</email
></address>
</affiliation>
</author>
<author
><firstname
>Michael</firstname
> <surname
>Zanetti</surname
> <affiliation
> <address
><email
>michael_zanetti@gmx.net</email
></address>
</affiliation>
</author>
<author
><firstname
>Gav</firstname
> <surname
>Wood</surname
> <affiliation
> <address
><email
>gav@kde.org</email
></address>
</affiliation>
</author>
<othercredit role="translator"
><firstname
>Marcus</firstname
><surname
>Gama</surname
><affiliation
><address
><email
>marcus.gama@gmail.com</email
></address
></affiliation
><contrib
>Tradução</contrib
></othercredit
>
</authorgroup>
<date
>2010-01-06</date>
<releaseinfo
>2.0</releaseinfo>
<copyright>
<year
>2004</year>
<holder
>Gav Wood</holder>
</copyright>
<copyright>
<year
>2010</year>
<holder
>Frank Scheffold</holder>
<holder
>Michael Zanetti</holder>
</copyright>
<!--
<legalnotice
>&FDLNotice;</legalnotice>
-->
<abstract
><para
>Configuração do &kdelirc; A infraestrutura para a funcionalidade de controle remoto por infravermelho do &kde;.</para
></abstract>
<keywordset>
<keyword
>KDE</keyword>
<keyword
>irkick</keyword>
<keyword
>kdelirc</keyword>
<keyword
>kcmlirc</keyword>
<keyword
>lirc</keyword>
</keywordset>
</bookinfo>
<chapter id="introduction">
<title
>Introdução</title>
<sect1 id="requirements">
<title
>Requisitos</title>
<para
>Para usar a plataforma do &kdelirc;, você deverá ter o LIRC configurado no seu computador. Se estiver devidamente configurado, o ícone do &kdelirc; na bandeja irá aparecer em vermelho <inlinemediaobject
><imageobject
><imagedata fileref="irkick.png" format="PNG"/></imageobject
></inlinemediaobject
>. Caso contrário, aparecerá em cinza e tracejado <inlinemediaobject
><imageobject
><imagedata fileref="irkickoff.png" format="PNG"/></imageobject
></inlinemediaobject
>. </para>
<para
>Para mais informações sobre o LIRC e como configurá-lo, visite a página Web do projeto em <ulink url="http://www.lirc.org/"
>http://www.lirc.org</ulink
>. </para>
<para
><emphasis role="strong"
>Nota:</emphasis
> Ao configurar o LIRC, recomenda-se que use os espaços de nomes dos botões. </para>
</sect1>
</chapter>
<chapter id="usage">
<title
>Utilização</title>
<para
>Existem três páginas que lhe fornecem diversas seções de configuração e informações adicionais. A primeira página, chamada <guibutton
>Funções do controlador</guibutton
>, é usada para configurar os modos e ações para todos os controles disponíveis. A página <guibutton
>Visão Geral dos Perfis</guibutton
> contém alguns detalhes sobre os perfis disponíveis. A página <guibutton
>Controles Disponíveis</guibutton
> mostra-lhe algumas informações adicionais sobre os seus controles remotos. Selecionar um controle apresenta uma ideia geral sobre os seus botões. </para>
<sect1 id="controllerFunctions">
<title
>Funções do Controlador</title>
<sect2 id="modes">
<title
>Controles remotos e modos</title>
<para
>Cada controle remoto poderá ter um conjunto de modos. Ter vários modos permite que o mesmo botão execute ações diferentes em diferentes situações. Um bom exemplo são os controles remotos multi-usos para TV/Vídeo/Satélite/DVD - em vez de usar vários controles remotos para os diferentes aparelhos, você pode mudar o comportamento de um controle remoto para adaptá-lo a um aparelho, criando modos diferentes e alternando entre eles conforme suas necessidades. </para>
<para
>As ações definidas diretamente para o controle remoto estão sempre disponíveis, independentemente do modo em que está o controle no momento. As ações definidas num determinado modo só são executadas se o controle estiver definido no momento para esse modo. Cada controle remoto só poderá estar num modo de cada vez. Ele também poderá estar sem qualquer modo, o que significa que só são executadas as ações sempre disponíveis, sempre que pressionar um botão. Você poderá também definir um modo padrão, o qual será o modo atribuído automaticamente na inicialização. </para>
<para
>A lista contém todos os controles remotos detectados no seu sistema. Os modos poderão ser adicionados e removidos se selecionar o controle remoto desejado e se usar os botões diretamente abaixo da lista. O botão Editar permite a edição dos modos existentes. </para>
</sect2>
<sect2 id="addactions">
<title
>Atribuir ações aos botões</title>
<para
>O &kdelirc; conhece dois tipos diferentes de ações. As opções do modo e as ações a executar. As opções do modo permitem alterar o comando atual para um modo diferente, enquanto as ações normais permitem a execução de comandos através de &DBus;. Ao definir uma nova ação executável, você terá duas opções. Uma é usar um modelo, enquanto a outra obriga a definir manualmente todas as opções possíveis. Os modelos das ações são chamados de perfis. Embora a utilização de perfis para criar ações seja muito mais simples e intuitiva, não é possível acessar a todas as funções com os perfis. As ações mais avançadas poderão ser configuradas se selecionar manualmente as funções e os seus parâmetros. </para>
<para
>Para adicionar uma ação, use o botão <guibutton
>Adicionar...</guibutton
> no canto inferior direito. Irá aparecer um assistente que lhe pergunta o tipo de ação que deseja criar. A primeira opção irá criar uma ação com base num perfil. A segunda opção permite-lhe criar manualmente a ação. Lembre-se que a aplicação que deseja controlar deverá estar em execução no momento em que configura a ação, ou então não irá aparecer na lista de aplicações disponíveis. A terceira opção permite criar uma ação de mudança de modo. Selecione o tipo desejado da ação e siga os passos por todo o assistente. </para>
<para
>As ações também poderão ser preenchidas automaticamente com o botão <guibutton
>Auto-povoar...</guibutton
>. Isto significa que o &kdelirc; poderá tentar corresponder os botões a funções para você. A janela de auto-povoamento mostra todos os perfis disponíveis com uma bandeira. Dependendo da cor da bandeira, o seu comando é suportado por completo, parcialmente ou não suportado por esse perfil. O verde corresponde ao suporte completo, o amarelo ao suporte parcial e o vermelho à ausência de suporte. </para>
<para
><emphasis role="strong"
>Nota:</emphasis
> Se o seu controle remoto não for compatível com nenhum perfil, você poderá não ter configurado o Lirc com espaços de nomes. </para>
</sect2>
</sect1>
<sect1 id="profiles">
<title
>Visão Geral dos Perfis</title>
<para
>A página de <guibutton
>Visão Geral dos Perfis</guibutton
> fornece alguma informação sobre os perfis disponíveis. Ao selecionar um perfil, você poderá ver algumas informações detalhadas, como os detalhes do autor e uma lista com todas as ações definidas. Cada item de ação contém informações sobre as opções adicionais, um comentário e o identificador do botão a usar pela função de preenchimento automático. </para>
<para
>Se você quiser contribuir com perfis de aplicações, veja o capítulo de <link linkend="advancedInformation"
>informação avançada</link
>. </para>
</sect1>
<sect1 id="availableRemotes">
<title
>Controles Disponíveis</title>
<para
>Esta página fornece informações detalhadas sobre os seus controles remotos. Você poderá verificar aqui se os seus controles remotos foram reconhecidos corretamente pelo sistema. </para>
</sect1>
</chapter>
<chapter id="advancedInformation">
<title
>Informação Avançada</title>
<para
>Este capítulo irá discutir mais algumas informações que poderão ser interessantes para usuários avançados ou programadores. Você irá aprender a criar os seus próprios perfis. </para>
<sect1 id="profileCreation">
<title
>Criação do Perfil</title>
<sect2>
<title
>Introdução</title>
<para
>Todas as aplicações com suporte para &DBus; poderão ser usadas com o &kdelirc; sem quaisquer ações posteriores. Contudo, para fornecer uma configuração amigável e permitir à aplicação aparecer na janela de auto-povoamento (preenchimento automático), você poderá querer criar um perfil para ele. </para>
<para
>Um perfil diz ao &kdelirc; (e ao usuário!) o que as várias chamadas de &DBus; fazem. Essencialmente, é uma espécie de documentação das chamadas de &DBus;. Você não terá que incluir todas as chamadas de &DBus; - apenas as que acha que os usuários iriam se beneficiar mais (normalmente as chamadas de <quote
>ajuste da interface</quote
> em vez das chamadas de <quote
>coleta de informações</quote
>). </para>
</sect2>
<sect2>
<title
>Criação</title>
<procedure>
<step>
<title
>&DBus;</title>
<para
>Certifique-se de que a aplicação para a qual quer criar o perfil dispõe de funções através do &DBus;. Basicamente, você poderá verificar isto ao tentar adicionar ações para essa aplicação, usando o método manual no &kdelirc;. A aplicação <quote
>qdbusviewer</quote
>, que vem com a sua instalação do Qt4, também é uma ótima ferramenta para descobrir as capacidades de &DBus; por parte das aplicações. </para>
</step>
<step>
<title
>Criar um perfil</title>
<para
>Assim que tenha descoberto as funções apropriadas de &DBus;, você terá que descrevê-las num documento <filename
>aplicação.profile.xml</filename
>. Aqui está um guia rápido sobre como criar esses arquivos: </para>
<substeps>
<step>
<para
>Crie primeiro um novo arquivo que contém os seguintes dados. Substitua o <quote
>minha-aplicação</quote
> pelo nome do executável da aplicação e <quote
>Minha Aplicação</quote
> por um nome de aplicação descritivo. </para>
<programlisting
><?xml version="1.0" ?>
<!DOCTYPE profile SYSTEM "profile.dtd">
<profile id="minha-aplicação" servicename="Minha Aplicação">
</profile>
</programlisting>
</step>
<step>
<para
>Dentro da marca <quote
>profile</quote
>, adicione o nome e a informação do autor. A marca <quote
>instances</quote
> diz ao &kdelirc; se a aplicação poderá ser executada várias vezes ou não. Configure o <quote
>unique</quote
> como <quote
>0</quote
> se puder iniciar a aplicação várias vezes (por padrão, é igual a <quote
>1</quote
>). A propriedade <quote
>ifmulti</quote
> define o que o &kdelirc; deverá fazer, se existirem várias instâncias rodando, quando pressionar num botão. As opções são <quote
>dontsend</quote
> (não fazer nada se >1 instância), <quote
>sendtoone</quote
> (enviar a chamada a uma instância escolhida de forma arbitrária) e <quote
>sendtoall</quote
> (enviar a todas as instâncias). O valor padrão é <quote
>dontsend</quote
>, contudo, o <quote
>sendtoone</quote
> poderá ser o mais útil em muitas circunstâncias. </para>
<programlisting
><?xml version="1.0" ?>
<!DOCTYPE profile SYSTEM "profile.dtd">
<profile id="minha-aplicação" servicename="Minha Aplicação">
<name>Minha Aplicação</name>
<author>Eu</author>
<instances unique="0" ifmulti="sendtoone"/>
</profile>
</programlisting>
</step>
<step>
<para
>Preencha o perfil com as marcas de ações 'action'. Cada uma dessas marcas deverá conter o nome do objeto de &DBus; e o protótipo da função. </para>
<para
>O &kdelirc; necessita de alguns atributos adicionais para saber como lidar com uma ação. A marca <quote
>button</quote
> é usada para a função de preenchimento automático. Veja a <ulink url="http://api.kde.org/4.x-api/kdebase-workspace-apidocs/libs/solid/html/classSolid_1_1Control_1_1RemoteControlButton.html"
>documentação da API do Solid</ulink
> para obter uma lista completa dos nomes dos botões disponíveis. A marca <quote
>repeat</quote
> diz se a ação deverá ser executada várias vezes, caso o botão do comando se mantenha pressionado (0 = Não, 1 = Sim). A marca <quote
>autostart</quote
> define se a aplicação deverá ser iniciada, caso não esteja já em execução. </para>
<programlisting
><?xml version="1.0" ?>
<!DOCTYPE profile SYSTEM "profile.dtd">
<profile id="minha-aplicação" servicename="Minha Aplicação">
<name>Minha Aplicação</name>
<author>Eu</author>
<instances unique="0" ifmulti="sendtoone"/>
<action objid="MinhaAplicação" prototype="void mostrarInt(short numero)"
button="Menu" repeat="0" autostart="0">
</action>
</profile>
</programlisting>
</step>
<step>
<para
>Adicione um nome e um comentário à ação. Isto é mostrado na interface do usuário do &kdelirc;. </para>
<programlisting
><?xml version="1.0" ?>
<!DOCTYPE profile SYSTEM "profile.dtd">
<profile id="minha-aplicação" servicename="Minha Aplicação">
<name>Minha Aplicação</name>
<author>Eu</author>
<instances unique="0" ifmulti="sendtoone"/>
<action objid="MinhaAplicação" prototype="void mostrarInt(short numero)"
button="Menu" repeat="0" autostart="0">
<name>Mostrar um Inteiro</name>
<comment>Mostra um número inteiro configurável</comment>
</action>
</profile>
</programlisting>
</step>
<step>
<para
>Descreva cada argumento com um comentário e um atributo de tipo. Uma lista com os tipos válidos poderá ser encontrada no <ulink url="http://websvn.kde.org/trunk/KDE/kdeutils/kdelirc/profiles/profile.dtd?view=markup"
>arquivo de descrição dos perfis</ulink
>. Você deverá declarar um valor padrão para cada argumento, dentro das marcas <quote
>default</quote
>: </para>
<programlisting
><?xml version="1.0" ?>
<!DOCTYPE profile SYSTEM "profile.dtd">
<profile id="minha-aplicação" servicename="Minha Aplicação">
<name>Minha Aplicação</name>
<author>Eu</author>
<instances unique="0" ifmulti="sendtoone"/>
<action objid="MinhaAplicação" prototype="void mostrarInt(short numero)"
button="Menu" repeat="0" autostart="0">
<name>Mostrar Inteiro</name>
<comment>Mostra um número inteiro configurável</comment>
<argument type="int">
<default>5</default>
<comment>O número inteiro a apresentar</comment>
</argument>
</action>
</profile>
</programlisting>
</step>
</substeps>
</step>
</procedure>
</sect2>
<sect2>
<title
>Instalação</title>
<para
>Para testar e usar o perfil, você terá que copiá-lo para o <filename
>$(kde_datadir)/profiles</filename
> e reiniciar o &kdelirc;. </para>
<para
>Se você quiser contribuir o perfil para o &kde; SC, envie-o por favor para a equipe do 'kdeutils' em <email
>kde-utils-devel@kde.org</email
>. </para>
</sect2>
</sect1>
</chapter>
</book>
<!--
Local Variables:
mode: sgml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:
// vim:ts=2:sw=2:tw=78:noet
-->
distrib
>
Mandriva
>
current
>
i586
>
media
>
main-updates
>
by-pkgid
>
abbb01628b6bad5577b076ab68c372f5
>
files
>
324
