Zaval Advanced TV Guide
(ATV)

Версия 2.0

Руководство пользователя

Zaval Creative Engineering Group

http://www.zaval.org

Содержание.

Введение.

Устанавливаем Zaval Advanced TV Guide.

  Требования.

  Процедура установки.

Устанавливаем Zaval ATV Parser.

  Требования.

  Процедура установки.

Работа с Zaval Advanced TV Guide.

  Общие сведения.

  Программы телепередач.

Работа с Zaval ATV Parser.

  Команда parse.

  Команды load/save.

  Команды list/fulllist.

  Команда now.

  Команда purge.

  Файл конфигурации atv.ini.

  TimeZone, разница во времени и т.п.

  Правила include/exclude.

  Кодировки.

  Примеры использования.

  Работа под разными операционками и кодировки.

Дальнейшие планы.

Поддержка.

Рассылка (последние новости).

Введение

Zaval Advanced TV Guide (более известный как ATV) -- это небольшая и удобная программа, которая позволяет просматривать программы телепередач на вашем PDA, таким образом, вы всегда будете в курсе последних новостей. С помощью нашего продукта вы можете легко отслеживать интересующие вас программы.

Zaval Advanced TV Guide лёгок в использовании, имеет интуитивно понятный интерфейс, а также обладает большими возможностями по работе с программой телепередач. В настоящее время существуют модули для работы со следующими сайтами:

• Euro TV (http://www.eurotv.com)
• НТВ+ (http://www.ntvplus.ru)
• Телевидение Аджарии (http://www.ajaratv.com)
• Вечерний Минск (http://newsvm.com)
• Cosmos TV (http://cosmostv.com)
• CityCat (http://www.citycat.ru/tv)
• RBC (http://tv.rbc.ru)
• VseTV (http://www.vsetv.com)

Это включает в себя такие всемирно известные каналы как EuroTV, BBC World, CNN, Discovery, а также российские ОРТ, НТВ, РТР и многие другие. При необходимости можно легко дописать отдельный модуль для любого другого сайта.

Zaval Advanced TV Guide поставляется в 4-х вариантах: с русским, английским, немецким и французским интерфейсом. При необходимости этот список может быть расширен.

Zaval Advanced TV Guide состоит из 2-х программ:

1. ATV-Palm - собственно программа для Palm'а;
2. ATV Parser - программа для загрузки/просмотра/конвертации ТВ-программы;

Устанавливаем Zaval Advanced TV Guide

Этот раздел подробно описывает процесс инсталляции Zaval ATV Guide.

Требования

PalmOS версии 3.x или выше.

Процедура установки

1. Распакуйте архив (zip или tar.gz) с ATV в пустую директорию.
2. Если Вы ранее использовали предыдущие версии ATV, то вначале удалите их (вместе с программами телепередач).
3. Установите файл atvpalm_LL_XXX.prc с привычной для вас локализацией на свой PDA:
   1. atvpalm_ru_XXX.prc - русифицированная версия;
   2. atvpalm_de_XXX.prc - немецкая версия;
   3. atvpalm_en_XXX.prc - английская версия;
   4. atvpalm_fr_XXX.prc - французская версия;

Если Вы успешно выполнили вышеописанное, то программа готова к работе. Для работы Вам необходимы сами программы телепередач. Для получения более подробной информации, как и где их достать, см. раздел Работа с Zaval Advanced TV Guide -> Программы телепередач.

Устанавливаем Zaval ATV Parser

Этот раздел подробно описывает процесс инсталляции Zaval ATV Parser. В действительности Zaval ATV Parser нужен только в случае, когда вы хотите самостоятельно формировать файлы с ТВ-программами. Для получения более подробной информации см. раздел Работа с Zaval Advanced TV Guide -> Программы телепередач.

Требования

Java Runtime Environment (или JDK) версии 1.4.x или выше. Можно скачать с java.sun.com (выберите интернациональную версию).

Процедура установки

• Распакуйте архив (zip или tar.gz) с ATV Parser в пустую директорию.

Собственно, это и всё - ATV Parser готов к использованию.

Работа с Zaval Advanced TV Guide

Этот раздел подробно описывает все возможности продукта и на примерах поясняет принципы его работы.

Общие сведения

Для начала обратим внимание на внешний вид Zaval Advanced TV Guide - см Рис.1):

Рис.1 ATV - внешний вид

На экране видны 3 колонки - время начала передачи, название(передачи с анонсами - подчеркнуты), и отметка (Alarm). Анонс можно посмотреть, ткнув пером на название передачи. В принципе, всё интуитивно понятно - список каналов со списком программ для каждого из них.

Кроме того, имеются фильтры - возможность просматривать не всю доступную информацию, а лишь определённую часть.

Zaval Advanced TV Guide поддерживает 3 типа фильтров:

• по каналам
• по времени
• выбрано/не выбрано

Рассмотрим на примерах.

Примечание: для скроллинга можно использовать не только полосу прокрутки, но и кнопки "вверх" и "вниз".

Допустим, нужно просмотреть только программы, которые идут прямо сейчас (на протяжении какого-то времени от текущего момента включительно). Для этого существует фильтр по времени (см. Рис.2). Аналогично можно просмотреть только программу на "сегодня" и т.д.

Рис.2 ATV - фильтр по времени

Другой тип фильтров - это фильтры на основе выбора. Предположим, что, просмотрев программу, Вы выбрали (отметили галочками) интересные, на Ваш взгляд, передачи и теперь хотели бы видеть лишь список выбранных. Именно для этого и предназначен данный фильтр - см. Рис.3.

Рис.3 ATV - фильтр на основе выбора

Ещё один тип фильтров - это фильтр по каналам. Довольно удобно просматривать программу не на все каналы сразу, а оперировать лишь небольшим списком. С помощью данного фильтра это как раз и делается - см. Рис.4.

Рис.4 ATV - фильтр по каналам

Если необходимо просмотреть программы лишь для одного канала - тоже не проблема, применяем опять же фильтр по каналам - см. Рис.5.

Рис.5 ATV - просматриваем программу на один канал

В некоторых газетах публикуют программу с краткими аннотациями к некоторым передачам. Аналогичная возможность предусмотрена и у нас - см. Рис.6. Для просмотра аннотации достаточно кликнуть на выделенной передаче.

Рис.6 ATV - аннотация к программе

Для удобства работы некоторые из настроек можно менять:

• время начала "дня";
• на какой промежуток времени показывать программы при выборе "сейчас";
• правила сортировки;
• TimeZone(только для PalmOS 3.x. Для PalmOS 4.x и выше настройки берутся из системы - если у вас возникли проблемы со временем, то сначала проверьте системные настройки);

И некоторые другие - см. Рис.7.

Рис.7 ATV - настройки

Новые фичи добавленные в версии 2.0:

Оповещения звуком за определённое время до начала выбранной программы

Рис.8 ATV - Настройка звукового оповещения

Поддержка различных шрифтов для Sony Clie (4 типа)

Рис.9 ATV - Настройка шрифтов

Программы телепередач

Программы телепередач - это xml-файлы, с которыми и работает ATV Guide. Существует несколько способов их достать:

1. Самый простой - скачать их с нашего сайта http://www.zaval.org/products/atv/data/. Мы их постоянно обновляем, так что никаких проблем с актуальностью быть не должно.
2. Вы можете сформировать их сами с помощью ATV Parser - подробную инструкцию см. далее.

Примечание: все программы телепередач хранятся в формате pdb.

После того, как вы скачали/сформировали нужные вам ТВ-программы, закачайте соответствующие pdb-файлы на свой PDA.

Работа с Zaval ATV Parser

Zaval ATV Parser -- это утилита, позволяющая самостоятельно создавать ТВ-программы, просматривать их и преобразовывать в другие форматы.

Синтаксис: java -jar atv.jar <command>

Поддерживаемые команды:

• parse
• load/save
• list, fulllist
• now
• purge

Рассмотрим каждую более подробно.

Команда parse

Эта наиболее интересная команда служит для загрузки ТВ-программы из внешних источников.

Синтаксис:

java -jar atv.jar parse [имя_модуля] [--charset=<>] [файл1]...[файлN]

где:

• имя_модуля - название модуля, который будет парсить ТВ-программу.
  В настоящий момент поддерживаются:
  • eurotv (http://www.eurotv.com)
  • tvtodayde (http://www.tvtoday.de)
  • cosmostv (http://cosmostv.com)
  • vm (http://newsvm.com)
  • citycat (http://www.citycat.ru)
  • ajara (http://www.ajaratv.com)
  • vsetv (http://www.vsetv.com)
  • kulichki (http://www.kulichki.net)
  • ntvplus (http://www.ntvplus.ru)
  • caravankz (http://www.caravan.kz)
  • albadpua (http://www.tv.alba.dp.ua)
  • rbcru (http://tv.rbc.ru)
  Если не указывать имя модуля, будет выдан список полный доступных модулей.
• --charset=<charset> - можно задать кодировку обрабатываемых файлов. Опция может встречаться несколько раз, т.е.
  --charset=Cp1251 <список_файлов> --charset=UTF-8 <список_файлов>
• [файл1...N] - список файлов для обработки; если они указаны, программа пытается достать ТВ-программу из этих файлов; если ничего не указывать, т.е. дать команду java -jar atv.jar parse <имя модуля>, этот модуль сам полезет в Интернет и заберет программу прямо со своего сайта.

Команды load/save

Команда служит для конвертации между разными форматами хранения ТВ-программ.

Синтаксис:

java -jar atv.jar load [имя_модуля] [файл1]...[файлN]

или

java -jar atv.jar save [имя_модуля] [имя_файла]

Если имя модуля не указано - выдается список доступных модулей. На текущий момент доступны следующие модули: listtv(для ListTV), palm(для atv-palm), jtv(для JTV), internal(для atv). Команда загружает/сохраняет данные из/в нужный формат. Обычно в команде save имя файла можно не указывать - в этом случае используется имя по умолчанию. Аналогично с командой load.

Модуль JTV имеет свои особенности. Команда save использует имя файла как префикс, т.е. вы можете указывать имя каталога, куда будут сохраняться файлы. Команде load нужно указывать имена файлов без их расширения, так как на каждый канал должно существовать 2 файла с разными расширениями. Также можно указать после "load jtv" ключ --fromdir=<каталог> -- тогда будут загружены все файлы jtv из этого каталога.

Модуль Palm также имеет дополнительные параметры для команды save. Это значит, что программа для каждого канала выводится в отдельный pdb, а не в один и тот же. За это отвечает ключ --separate-channels. Другая возможность - выводить данные для всех каналов определённого сайта в один файл, но для разных сайтов это разные файлы.За эту фичу отвечает ключ --separate-sites.
Синтаксис: java -jar atv.jar save palm [--separate-channels | --separate-sites] [префикс_имени_файла_с_путём_до_файла]

Команды list/fulllist

Показывает список каналов(list) или список всех сохраненных программ(fulllist).

Команда now

Показывает список программ, идущих в данный момент.

Синтаксис:

java -jar atv.jar now [кол-во_часов]

где:

• кол-во_часов -- на какой промежуток времени показывать программы, начиная с текущего момента.

Команда purge

Удаляет информацию о старых передачах. Этой командой и надо чистить базу.

Синтаксис:

java -jar atv.jar purge [с_какого_времени]

Если не указано, с какого времени, то удаляются все передачи старше 24 часов.

Файл конфигурации atv.ini

Общее правило - часть строк, начинающаяся с символа '#', является комментарием и игнорируется.

Команды настройки прокси:

• local.proxy_host - задает имя http прокси-сервера. Если оно не задано, программа будет ходить на сайт напрямую;
• local.proxy_port - задает порт прокси(по умолчанию 8080);
• local.proxy_auth - при необходимости позволяет задать авторизацию на прокси, в виде имя:пароль;

Команды настройки списка программ:

• list.override - по умолчанию "no"; если установлено "yes", передачи будут перезаписываться новыми при загрузке, иначе будет оставаться старый вариант;
• list.defaultlength - длительность последней передачи по умолчанию в минутах; используется, если нельзя определить время из программы;
• local.TimeZone - см. раздел TimeZone, разница во времени и т.п.; по умолчанию использует системные настройки timezone;
• <module_name>.charset - см. раздел Кодировки;
• list.include - см. далее;
• list.exclude - см. далее;

TimeZone, разница во времени и т.п.

В связи с тем, что живем мы все в разных часовых поясах, приходится просчитывать разницу во времени начала программ. Внутри atv все время хранится в GMT, что упрощает эти расчеты. При выводе на экран (и сохранении в большинство форматов) время переводится в местное с помощью системной TimeZone. В Unix-системах ее можно установить переменной окружения TZ или в файле /etc/timezone. В Windows - мышью ;)

В качестве расчетов разницы во времени выбрана именно TimeZone, а не смещение от GMT и смещение для каждой программы. Это позволяет решить проблему перехода на зимнее и летнее время автоматически. Однако, если вам не нравится установленное значение, вы можете его изменить в atv.ini строкой local.TimeZone, в значение которой прописывается нужная TimeZone.

Ниже приведён список всех модулей с их TimeZone'ами по умолчанию:

• eurotv.TimeZone=Europe/EST;
• tvtodayde.TimeZone=Europe/Berlin;
• cosmostv.TimeZone=Europe/Minsk;
• kulichki.TimeZone=Europe/Moscow;
• ajara.TimeZone=Asia/Tbilisi;
• citycat.TimeZone=Europe/Moscow;
• vm.TimeZone=Europe/Minsk;
• vsetv.TimeZone=Europe/Moscow;
• ntvplus.TimeZone=Europe/Moscow
• caravankz.TimeZone=Asia/Almaty
• albadpua.TimeZone=Europe/Kiev
• rbcru.TimeZone=Europe/Moscow

Правила include/exclude

Введены следующие правила загрузки/незагрузки каналов (см. файл atv.ini):

Глобальные:

• list.include
• list.exclude

Для каждого модуля:

• <имя_модуля>.include
• <имя_модуля>.exclude

В каждом из этих параметров могут быть перечислены названия каналов (через ';'). Параметры для каждого модуля имеют приоритет, т.е. если в list.exclude указан какой-то канал и он же указан в <имя модуля>.include -- канал будет грузиться, но только этим модулем. Если канал указан в list.include и в <имя модуля>.exclude -- грузиться этим модулем он не будет. Если хоть один канал определен в include, никакие другие каналы, кроме этого, загружаться не будут. Если не определен ни один include (локальный для модуля или глобальный) -- модуль будет грузить все каналы, кроме exclude.

Кодировки

Все модули, поддерживающие load/save, понимают параметр <имя модуля>.charset. Этот параметр говорит, в какой кодировке будут загружаться и сохраняться данные. Если параметр не определен -- используется локальная кодировка Вашей системы. Кодировка должна быть в виде, воспринимаемой Java.

Примеры использования

"java -jar atv.jar parse citycat" - загружает программу из Интернета с сайта citycat

"java -jar atv.jar parse vm --charset=Cp1251 1.html 2.html 3.html" - загружает программу из файлов 1.html,2.html,3.html, которые взяты с сайта vm.agava.ru в кодировке 1251

"java -jar atv.jar save palm" - конвертирует ТВ-программу в формат palm (TVProgram.pdb)

"java -jar atv.jar load jtv ОРТ НТВ" - загружает программу из формата jtv из файлов ОРТ.* и НТВ.*

"java -jar atv.jar now 3" - показывает передачи, которые идут сейчас или будут идти на протяжении еще 3 часов

"java -jar atv.jar purge" - удаляет старые передачи

Работа под разными операционками и кодировки

По умолчанию в Windows используется кодировка Cp1251(при установке русского языка в региональных настройках), и файл atv.ini приведен именно в этой кодировке.

Для Unix-систем ситуация другая. Кодировка устанавливается в переменной окружения LANG, причем из-за особенностей java работать с кодировкой 1251 не получается. Есть два варианта -- пользоваться KOI8-R, тогда нужно установить LANG=ru_RU.KOI8-R, или Unicode(UTF8), для этого прописываем LANG=ru_RU.UTF-8. Второй вариант, IMHO, является более правильным.

Файл atv.ini должен быть в текущей выбранной кодировке, иначе java не сможет его распознать.

Дальнейшие планы

Текущая реализация программы представляет собой лишь необходимый минимум, в дальнейшем планируется добавить следующие фичи:

• записывать дублирующиеся названия в pdb только один раз
• непосредственная закачка файлов на PDA из интернета

Поддержка

Все найденные баги и вопросы по технической реализации продукта высылайте по адресу support@zaval.org с subject "Re: Zaval ATV Guide Support" в формате plain text. Поскольку продукт распространяется на правах General Public License и сопровождается его авторами на некоммерческой основе, Ваши запросы будут обработаны по мере возможности, но не позднее чем через 5 рабочих дней.

Zaval Creative Engineering Group выполняет оптимизацию существующих продуктов под нужды заказчика и разработку новых продуктов "с нуля". За дополнительной информацией обращайтесь по адресу info@zaval.org.

Рассылка (последние новости)

Дабы получать все сообщения о новых версиях продуктов нашей группы, а также найденных багах и путях их исправления, рекомендуется подписаться на рассылку. Для этого отправьте письмо по адресу news-subscribe@zaval.org. Сама рассылка довольно апериодична и в среднем составляет 2-3 письма в месяц, а то и реже.