OMOBUS ZHTML demo

В данном проекте приводится описание контейнера OMOBUS, используемого для отображения содержимого html презентаций, и пример демонстрационного html контента.

Правила оформления презентации

Презентация представляет собой набор файлов, упакованных в zip архив. В архиве должен присутствовать минимум один файл с названием index.html (в корневой папке), который вызывается непосредственно из контейнера OMOBUS. Расширенные параметры контейнера задаются в файле omobus.manifest. Основной кодировкой текстовых файлов является кодировка UTF-8. В случае использования отличных от UTF-8 кодировок, не гарантируется корректность отображения презентации.

Описание среды выполнения презентации

Презентация выполняется непосредственно в системе OMOBUS, в специальном контейнере, построенном на базе Android WebView (фактически - усеченный вариант web-браузера). В контейнере разрешено выполнение только локального содержимого, любые обращения к внешним источникам блокируются. Это означает, что в формируемом архиве презентации должно содержаться все необходимое для ее отображения.

Дополнительные JavaScript функции, предоставляемые контейнером OMOBUS:

1. Закрытие контейнера с выполняемой презентацией:

   omobus.quitContainer()

2. Регистрация факта начала отображения длительной операции:

   omobus.openSlide(name)

3. Регистрация факта окончания отображения длительной операции:

   omobus.closeSlide(name)

4. Регистрация факта единичного нажатия:

   omobus.registerClick(name)

5. Открытие ссылки в системном браузере:

   omobus.gotoRef(uri)

Во всех приведенных функциях, параметр name представляет собой уникальное (в рамках конкретной презентации) название действия. Количество символов в параметре name должно быть не более 32.

Указанные функции доступны только начиная с Android 4.2, поэтому необходимо в обязательном порядке проверять наличие объекта omobus, например, как сделано в следующем примере:

    if( typeof omobus == 'undefined' ) {
	console.log("Объект [omobus] не определен!");
    } else {
	omobus.quitContainer();
    }

Отладка выполнения презентации

Для получения отладочной информации, необходимо воспользоваться утилитой adb из Android Platform Tools, выполнив следующую команду:

> $ adb logcat -v time -e WebContent

или

> $ adb logcat -v time -e WebContent OMOBUS:*

в том случае, если необходимо отобразить всю информацию, включая отладочную.

COPYRIGHT

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