<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kremotecontrol "<application
>KRemoteControl</application
>">
  
  <!ENTITY % Ukrainian "INCLUDE"
> <!-- change language only here -->
  <!ENTITY % addindex "IGNORE">
]>

<book id="kremotecontrol" lang="&language;">
  <bookinfo>
    <title
>Налаштування пристроїв дистанційного керування у KDE</title>

    <authorgroup>
      <author
><firstname
>Michael</firstname
> <surname
>Zanetti</surname
> <affiliation
> <address
><email
>michael_zanetti@gmx.net</email
></address>
        </affiliation>
      </author>
    <othercredit role="translator"
><firstname
>Юрій</firstname
><surname
>Чорноіван</surname
><affiliation
><address
><email
>yurchor@ukr.net</email
></address
></affiliation
><contrib
>Переклад українською</contrib
></othercredit
> 
    </authorgroup>

    <date
>5 березня 2010 року</date>
    <releaseinfo
>1.0</releaseinfo>

    <copyright>
      <year
>2010</year>
      <holder
>Michael Zanetti</holder>
    </copyright>

    <abstract>
      <para
>Налаштування &kremotecontrol;: інфраструктура функціональних можливостей &kde; з роботи з пристроями дистанційного керування. </para>
    </abstract>
    
    <keywordset>
      <keyword
>KRemoteControl</keyword>
      <keyword
>kcm_remotecontrol</keyword>
      <keyword
>Дистанційне керування</keyword>
    </keywordset>

  </bookinfo>

  <chapter id="introduction">
    <title
>Вступ</title>

    <para
>За допомогою цього модуля ви зможете налаштувати роботу ваших пристроїв дистанційного керування. Ви зможете визначити дії, які виконуватимуться у відповідь на натискання кнопок. Дії можуть полягати у запуску програм, керуванні ними або виконанні системних команд, зокрема команди вимикання вашого комп’ютера. </para>

    <sect1 id="requirements">
      <title
>Вимоги</title>

      <para
>Щоб мати змогу скористатися &kremotecontrol;, вам слід встановити і налаштувати у вашій системі сумісний з програмою сервер роботи з пристроями дистанційного керування. У поточній версії єдиним таким сервером є LIRC. Якщо LIRC налаштовано належним чином, піктограма &kremotecontrol; у системному лотку набуде червоного кольору <inlinemediaobject
> <imageobject
> <imagedata fileref="irkick.png" format="PNG"/> </imageobject
> </inlinemediaobject
>. Якщо це не так, піктограму буде перекреслено і показано сірим кольором <inlinemediaobject
> <imageobject
> <imagedata fileref="irkickoff.png" format="PNG"/> </imageobject
> </inlinemediaobject
>. </para>

      <para
>Докладніші відомості щодо LIRC можна отримати з сайта проекту http://www.lirc.org. </para>

    </sect1>
  </chapter>

  <chapter id="usage">
    <title
>Використання</title>

    <para
>Сторінка модуля налаштування складається з двох списків. У списку, розташованому ліворуч, буде показано доступні пристрої дистанційного керування та їх режими. У списку, розташованому праворуч, буде показано всі налаштовані для поточного позначеного пульта або режиму дії. <screenshot>
      <screeninfo
>Налаштування KRemoteControl</screeninfo>
        <mediaobject>
          <imageobject>
            <imagedata fileref="kcmremotecontrol.png" format="PNG"/>
          </imageobject>
          <textobject>
            <phrase
>Списки пультів та налаштовані режими і дії</phrase>
          </textobject>
        </mediaobject>
      </screenshot>
    </para>

    <sect1 id="modes">
      <title
>Пульти керування і режими</title>

      <para
>Будь-який пульт дистанційного керування може працювати у декількох різних режимах. Використання декількох режимів уможливлює прив’язку натискання кнопок до різних дій за різних обставин. Розглянемо, наприклад, багатоцільовий пристрій дистанційного керування телевізором/відеомагнітофоном/супутниковою антенною/DVD-програвачем. Замість використання декількох пультів для різних програм, ви можете змінити поведінку одного пульта дистанційного керування для керування різними програма шляхом створення декількох режимів з вмиканням, за потреби, належного до певної ситуації режиму. Доступ до дій, пов’язаних безпосередньо з пультом дистанційного керування можна буде отримати за будь-яких обставин, незалежно від поточного режиму. Дії ж, пов’язані з певним режимом, виконуватимуться, лише якщо пульт працює у відповідному режимі. Одночасно пульт дистанційного керування може працювати лише у одному режимі. Крім того, пульт може працювати у без визначення режиму, коли доступ до дії буде обмежено лише загальним переліком дій. Ви також можете визначити типовий режим, у якому пульт працюватиме одразу після запуску системи. </para>
      <para
>Додати режим до пункту пристрою дистанційного керування можна позначенням цього пункту з наступним натисканням кнопки <guibutton
>+</guibutton
>, розташованої поруч зі списком. Під час створення запису режиму вам слід вказати його назву. За бажання ви можете призначити кнопку, якою вмикатиметься режим та піктограму, яку буде використано для сповіщень про цей режим. Вилучити запис режиму можна позначенням відповідного пункту з наступним натисканням кнопки <guibutton
>-</guibutton
>. <screenshot>
        <screeninfo
>Додавання режиму</screeninfo>
          <mediaobject>
            <imageobject>
              <imagedata fileref="AddMode.png" format="PNG"/>
            </imageobject>
            <textobject>
              <phrase
>Додавання нового режиму</phrase>
            </textobject>
          </mediaobject>
        </screenshot>
      </para>
      <para
>Типово, якщо існує декілька режимів, у яких різні дії пов’язано з однією кнопкою, для перемикання між режимами використовується кнопка перемикання режимів. За допомогою таких кнопок можна групувати ваші режими. Наприклад, ви можете призначити кнопку з назвою <quote
>Music</quote
> для циклічного перемикання режимів у &amarok; і &juk;, а кнопку з назвою <quote
>Video</quote
> для циклічного перемикання режимів у Dragonplayer або KMplayer. Якщо ви надаєте перевагу циклічному перемиканню режимів за допомогою однієї кнопки, а іншою кнопкою бажаєте користуватися для циклічного перемикання режимів у зворотному напрямку, ви можете налаштувати подібну поведінку у параметрах пульта, натисканням кнопки редагування даних. <screenshot>
        <screeninfo
>Редагування запису пульта</screeninfo>
          <mediaobject>
            <imageobject>
              <imagedata fileref="EditMasterMode.png" format="PNG"/>
            </imageobject>
            <textobject>
              <phrase
>Редагування параметрів пульта</phrase>
            </textobject>
          </mediaobject>
        </screenshot>
      </para>

    </sect1>

    <sect1 id="actions">
      <title
>Дії</title>

      <para
>Після позначення пункту пульта або режиму ви можете додавати записи дій за допомогою натискання кнопки <guibutton
>+</guibutton
>, розташованої праворуч. Передбачено два різних способи створення записів дій: за допомогою шаблонів або за допомогою безпосередньої навігації каналами сеансу D-Bus. <screenshot>
        <screeninfo
>Додавання дії</screeninfo>
          <mediaobject>
            <imageobject>
              <imagedata fileref="AddAction.png" format="PNG"/>
            </imageobject>
            <textobject>
              <phrase
>Додавання запису дії</phrase>
            </textobject>
          </mediaobject>
        </screenshot>
      </para>
      <para
>Створення записів дій за допомогою шаблонів є простішим, але має певні обмеження. Передбачено шаблони для більшості типових програм, зокрема &amarok;, інструменту запуску програм KDE та системних команд, зокрема команд вимикання комп’ютера. Записи шаблонів зібрано у профілі за призначенням. Наприклад, існує профіль з назвою <quote
>Power management</quote
>, у якому зібрано шаблони, призначені для вимикання або присипляння системи. <screenshot>
        <screeninfo
>Додавання за профілем дій</screeninfo>
          <mediaobject>
            <imageobject>
              <imagedata fileref="AddProfileAction.png" format="PNG"/>
            </imageobject>
            <textobject>
              <phrase
>Додавання дії за допомогою шаблону</phrase>
            </textobject>
          </mediaobject>
        </screenshot>
      </para>
      <para
>Якщо ви виберете варіант з навігацією каналами сеансу D-Bus, програма покаже список всіх поточних запущених програм. Ви зможете здійснювати навігацію списком програм та їх функцій. Створення записів дій за допомогою цього способу вимагає базового розуміння способів роботи D-Bus, але ви зможете скористатися ширшим переліком програм та функцій, ніж за допомогою списку шаблонів. <screenshot>
        <screeninfo
>Додавання дії за допомогою D-Bus</screeninfo>
          <mediaobject>
            <imageobject>
              <imagedata fileref="AddDBusAction.png" format="PNG"/>
            </imageobject>
            <textobject>
              <phrase
>Додавання запису дії за допомогою D-Bus</phrase>
            </textobject>
          </mediaobject>
        </screenshot>
      </para>
      <para
>Під час додавання запису дії ви зможете змінити деякі з параметрів дії. Першим з таких параметрів є повторюваність дії у разі утримування натисненою кнопки на пульті керування. Подібна повторюваність може знадобитися для дії зі збільшення або зменшення гучності, але є небажаною для дії з відтворення/призупинення відтворення у програвачах. Другий параметр визначає, чи слід запускати програму, якщо її ще не запущено на час натискання кнопки. Подібний запуск є небажаним, якщо слід виконати дію, наприклад, з завершення роботи програми. Третім і останнім параметром є параметр визначення екземпляра програми, який має отримати наказ щодо виконання дії, якщо запущено декілька екземплярів програми. Якщо ви позначили пункт програми, для якої не передбачено запуску декількох екземплярів, відповідний пункт буде вимкнено. </para>
      <para>
        <screenshot>
        <screeninfo
>Додавання параметрів дії</screeninfo>
          <mediaobject>
            <imageobject>
              <imagedata fileref="AddActionOptions.png" format="PNG"/>
            </imageobject>
            <textobject>
              <phrase
>Параметри дій</phrase>
            </textobject>
          </mediaobject>
        </screenshot>
      </para>
      <para
>Записи дій може бути створено автоматично за допомогою натискання кнопки майстра налаштування. Після натискання цієї кнопки &kremotecontrol; спробує встановити відповідність між кнопками та функціями. У діалоговому вікна автозаповнення буде показано пункти всіх можливих збірок шаблонів з прапорцями. Колір прапорця позначатиме степінь підтримки вашого пульта дистанційного керування профілем: повністю, частково або не підтримується. Зеленим буде позначено профіль, всі шаблони якого можна застосувати до вашого пульта, жовтим — лише деякі шаблони, червоним буде позначено профілі, які не вдалося пов’язати з кнопками вашого пульта дистанційного керування. Позначення профілю червоним кольором не означає, що ви не зможете ним скористатися. Вам лише треба буде його налаштувати, призначивши кнопки до дій вручну. <screenshot>
        <screeninfo
>Автозаповнення</screeninfo>
          <mediaobject>
            <imageobject>
              <imagedata fileref="AutoPopulate.png" format="PNG"/>
            </imageobject>
            <textobject>
              <phrase
>Автоматичне створення дій за допомогою шаблонів</phrase>
            </textobject>
          </mediaobject>
        </screenshot>
      </para>
      <para
><emphasis role="strong"
>Зауваження:</emphasis
> якщо ваш пульт віддаленого керування несумісний з жодним з профілів, ймовірно, ви не налаштували LIRC на використання просторів назв кнопок. </para>
    </sect1>
  </chapter>
  <chapter id="advancedInformation">
    <title
>Додаткова інформація</title>
    <para
>У цій главі ми обговоримо деякі речі, які можуть зацікавити досвідчених користувачів та розробників. За її допомогою ви зможете навчитися створенню власних профілів. </para>

    <sect1 id="profileCreation">
      <title
>Створення профілю</title>

      <sect2>
        <title
>Вступ</title>
        <para
>За допомогою &kremotecontrol; можна користуватися майже всіма програмами, що підтримують роботу з &DBus;, без додаткових налаштувань. Але щоб програму легше було налаштовувати і щоб пункт програми з’явився у діалоговому вікні автоматичного заповнення, вам доведеться створити профіль для програми. </para>
        <para
>За допомогою профілю ви повідомите &kremotecontrol; (і користувачеві!) про те, які дії виконуються у відповідь на кожен з викликів &DBus;. Профіль — це різновид документації до викликів &DBus;. Вам не обов’язково описувати всі виклики &DBus; — достатньо лише тих, які будуть найкориснішими для користувачів (це зазвичай виклики «коригування інтерфейсу», а не виклики «збирання відомостей»). </para>
      </sect2>

      <sect2>
        <title
>Настанови щодо профілів</title>
        <procedure>

          <step>
            <title
>&DBus;</title>
            <para
>Переконайтеся, що програма, для якої ви бажаєте створити профіль, може керуватися за допомогою каналу сеансу &DBus;. Це можна перевірити так: спробуйте додати дії для цієї програми за допомогою &kremotecontrol; вручну. Чудовим інструментом для виконання цього завдання є також програма <quote
>qdbusviewer</quote
>, яка постачається разом з бібліотекою Qt4. За допомогою цієї програми ви зможете дізнатися про можливості керування програмою за допомогою &DBus;. </para>
          </step>

          <step>
            <title
>Покрокова інструкція</title>
            <para
>Після визначення відповідних функцій &DBus; вам слід описати їх у документі <filename
>appname.profile.xml</filename
>. Ось короткі настанови щодо створення таких документів: </para>

            <substeps>
              <step>
                <para
>Спочатку створіть файл, що міститиме рядки, наведені нижче. Теґ <quote
>name</quote
> визначає коротку описову назву вашого профілю. За допомогою теґу <quote
>description</quote
> можна додати до вашого профілю опис. Крім того, додайте ваше ім’я у теґ <quote
>author</quote
> і номер версії у теґ <quote
>version</quote
>. Номер версії важливий для оновлення ваших профілів. &kremotecontrol; використовуватиме профіль з найвищим номером версії, якщо виявить у вашій системі профілі різних версій. </para>
                <programlisting
>&lt;xml version="1.0" encoding="UTF-8"?>
&lt;profile xmlns="urn:org-kde-kremotecontrol"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="urn:org-kde-kremotecontrol file:profile.xsd"&gt;

    &lt;name&gt;My Profile&lt;/name&gt;
    &lt;version&gt;0.1&lt;/version&gt;
    &lt;author&gt;Я&lt;/author&gt;
    &lt;description&gt;Якийсь опис призначення профілю&lt;/description&gt;
    &lt;action&gt;
        &lt;--  Пояснення щодо цього теґу буде надано нижче--&gt;
    &lt;action&gt;

&lt;/profile&gt;
                </programlisting>
              </step>

              <step>
                <para
>Після створення каркасу профілю час додати до нього декілька шаблонів дій. </para>

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

    &lt;name&gt;My Profile&lt;/name&gt;
    &lt;version&gt;0.1&lt;/version&gt;
    &lt;author&gt;Я&lt;/author&gt;
    &lt;description&gt;Якийсь опис призначення профілю&lt;/description&gt;

    &lt;action id="someUniquId"  repeat="true|false" button="someButton"&gt;
      &lt;name&gt;Моя дія&lt;/name&gt;
      &lt;description&gt;Призначення дії&lt;/description&gt;
      &lt;prototype&gt;
        &lt;--  Пояснення щодо цього теґу буде надано нижче--&gt;
      &lt;prototype&gt;
      &lt;ifmulti&gt;ifMultiOption&lt;/ifmulti&gt;
    &lt;/action&gt;
    
&lt;/profile&gt;
                </programlisting>
               <para
>Спочатку визначте унікальний ідентифікатор. Його буде використано &kremotecontrol; для прив’язки записі дій до шаблону, наприклад для читання опису. Ідентифікатор не повинен повторюватися у межах профілю. Атрибут <quote
>button</quote
> буде використано для автозаповнення. Повний список можливих назв кнопок можна знайти у файлі схеми <quote
>profile.xsd</quote
>. За допомогою атрибута <quote
>repeat</quote
> можна визначити, чи буде дія повторюватися, якщо ви утримуватимете натисненою кнопку на пульті. Якщо після натискання кнопки дії у програмі, яку ще не запущено, системі слід запустити цю програму, встановіть для атрибута <quote
>autostart</quote
> значення <quote
>true</quote
>. Атрибути <quote
>button</quote
>, <quote
>repeat</quote
> і <quote
>autostart</quote
> є необов’язковими. Якщо значення <quote
>repeat</quote
> і <quote
>autostart</quote
> не буде визначено, типовими значеннями вважатимуться <quote
>false</quote
>. </para>
                 
               <para
>Додайте коротку назву у теґ <quote
>name</quote
> та опису у теґ <quote
>description</quote
>. За допомогою властивості <quote
>ifmulti</quote
> можна визначити спосіб дій &kremotecontrol;, якщо на час натискання кнопки буде запущено декілька екземплярів програми. Ви можете скористатися такими значеннями властивості: <quote
>sendtotop</quote
> (надіслати виклик найвищому екземпляру у стосі вікон), <quote
>sendtobottom</quote
> (надіслати виклик найнижчому екземпляру у стосі вікон), <quote
>sendtoall</quote
> (надіслати всім екземплярам), <quote
>dontsend</quote
> (не надсилати виклик жодному екземпляру) і <quote
>unique</quote
> (можливий запуск лише одного екземпляра цієї програми). Якщо цей теґ не буде визначено, &kremotecontrol; вважатиме, що запуск декількох екземплярів програми неможливий, отже типовим значенням теґ буде <quote
>unique</quote
>. </para>
              </step>

              <step>
                <para
>Далі, визначимо функцію &DBus;, яку слід виконати у тезі <quote
>prototype</quote
>: </para>
                <programlisting
>&lt;?xml version="1.0" encoding="UTF-8"?>
&lt;profile xmlns="urn:org-kde-kremotecontrol"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="urn:org-kde-kremotecontrol file:profile.xsd"&gt;

    &lt;name&gt;My Profile&lt;/name&gt;
    &lt;version&gt;0.1&lt;/version&gt;
    &lt;author&gt;Я&lt;/author&gt;
    &lt;description&gt;Якийсь опис призначення профілю&lt;/description&gt;

    &lt;action id="someUniquId"  repeat="true|false" button="someButton"&gt;
      &lt;name&gt;Моя дія&lt;/name&gt;
      &lt;description&gt;Призначення дії&lt;/description&gt;

      &lt;prototype&gt;
        &lt;serviceName&gt;org.приклад.програма&lt;/serviceName&gt;
        &lt;node&gt;Якийсь/Вузол&lt;/node&gt;
        &lt;function&gt;функція&lt;/function&gt;
      &lt;/prototype&gt;

      &lt;ifmulti&gt;ifMultiOption&lt;/ifmulti&gt;
    &lt;/action&gt;
    
&lt;/profile&gt;
                </programlisting>
                <para
>Теґ <quote
>servicename</quote
> містить назву служби &DBus; програми, наприклад <quote
>org.kde.plasma-desktop</quote
>. <quote
>node</quote
> містить відповідний вузол &DBus;, зокрема <quote
>App</quote
>. Додайте назву функції без значення, яке вона повертає і аргументів за допомогою теґу <quote
>function</quote
>. Приклад: <quote
>toggleDashboard</quote
>. </para>
              </step>

              <step>
                <para
>Якщо функції слід передати аргументи, вам слід описати кожен з них: опис для користувача, тип і, необов’язково, типове значення. Зі списком підтримуваних типів можна ознайомитися у файлі схеми <quote
>profile.xsd</quote
>. Теґ <quote
>comment</quote
> має містити зрозумілий користувачеві опис призначення аргументу. Крім того, вам слід оголосити типове значення для кожного аргументу у тезі <quote
>default</quote
>. Зауважте, що у шаблонах з кнопкою слід вказувати типові значення всіх аргументів, інакше автозаповнення створюватиме помилкові записи функцій. </para>
      
                  <programlisting
>&lt;?xml version="1.0" encoding="UTF-8"?>
&lt;profile xmlns="urn:org-kde-kremotecontrol"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="urn:org-kde-kremotecontrol file:profile.xsd"&gt;

    &lt;name&gt;My Profile&lt;/name&gt;
    &lt;version&gt;0.1&lt;/version&gt;
    &lt;author&gt;Я&lt;/author&gt;
    &lt;description&gt;Якийсь опис призначення профілю&lt;/description&gt;

    &lt;action id="someUniquId"  repeat="true|false" button="someButton"&gt;
      &lt;name&gt;Моя дія&lt;/name&gt;
      &lt;description&gt;Призначення дії&lt;/description&gt;

      &lt;prototype&gt;
        &lt;serviceName&gt;org.приклад.програма&lt;/serviceName&gt;
        &lt;node&gt;Якийсь/Вузол&lt;/node&gt;
        &lt;function&gt;функція&lt;/function&gt;

        &lt;arguments&gt;
          &lt;argument type="QString"&gt;
            &lt;comment&gt;Додатковий коментар&lt;/comment&gt;
            &lt;default&gt;якесьЗначення&lt;/default&gt;
          &lt;/argument&gt;
        &lt;/arguments&gt;

      &lt;/prototype&gt;

      &lt;ifmulti&gt;ifMultiOption&lt;/ifmulti&gt;
    &lt;/action&gt;
    
&lt;/profile&gt;
                  </programlisting>
              </step>
            </substeps>
          </step>
        </procedure>
      </sect2>
      <sect2>
        <title
>Встановлення</title>
          <para
>Щоб перевірити та використовувати профіль, вам слід скопіювати його до <filename
>$(kde_datadir)/profiles</filename
> і перезапустити &kremotecontrol;. </para>
          <para
>Якщо ви бажаєте додати ваш профіль до типового пакунка &kde;, будь ласка, надішліть його команді розробки kdeutils на адресу <email
>kde-utils-devel@kde.org</email
>. </para>
        </sect2>
    </sect1>
  </chapter>
</book>
