Настройка XML браузера

Материал из wiki.akuvox-rus.ru
Версия от 12:25, 20 августа 2020; Admin (обсуждение | вклад)
(разн.) ← Предыдущая | Текущая версия (разн.) | Следующая → (разн.)
Перейти к навигации Перейти к поиску

XML браузер это простой браузер на базе языка XML и сервисов http/https для SIP телефона. Языки программирования такие, как Php, javascript могут быть использованы на сервере для генерации подходящих XML файлов для SIP телефона для их загрузки через http/https. С помощью XML браузера можно реализовывать персонализированную конфигурацию, например, проверять прогноз погоды, акции, дату / время или контакт; поиск в google; воспроизводить музыку или настраивать другие подобные устройства

XML браузер поддерживает следующие типы XML файлов:

1.TextMenu: это меню в текстовом формате.

2.TextScreen: отображение подробной информации в виде текста.

3.InputScreen: Ввод информации от пользователя, похоже на интерфейс регистрации аккаунта.

4.Directory: Загрузка телефонной книги.

Настройка XML браузера

Настройка кнопки XML Браузера через веб интерфейс 1.Войдите по IP устройства в веб интерфейс;

2.Выберите любую кнопку line key, soft key, function key или DSS key в разделе Phone(Телефон)→Key/Display(Кнопки/Отображение) или DSS Key.Укажите тип как XML браузер, введите корректный URL для xml файлов в поле Value(значение) и нажмите submit для подтверждения.

1zz.png

3. Пользователи могут настроить локальный сервер с помощью определенных файлов браузера xml или ввести адрес удаленного сервера, например http://65.205.71.13/xml/weather/weather.php в поле value(значение) для получения данных или информации.

Настройка сервера XML браузера

XML браузер поддерживает загрузку через Http/Https/tftp/ftp. 1.Поднимите Http/Https/tftp/ftp сервер.

2.Разместите файлы XML браузера в специальную директорию, как показано ниже в примере для tftp:

2zz.png

3.Запустите tftp32.exe.

4.Введите URL для XML файлов в поле value для завершения настроек

Настройка XML браузера на экране устройства

1.Откройте Menu(Меню) → Features(Функции) → Programmable Keys(Программируемые кнопки) → Line Keys/Soft Keys/Function Keys/DSS keys.

2.Выберите XML браузер в качестве типа и введите URL сервера, как показано ниже

3zz.png

3.В интерфейсе ожидания нажмите кнопку XML браузера для доступа к XML файлам.

Формат XML файла

Нажмите кнопку XML браузера для входа в интерфейс XML. Ниже показаны 4 типа интерфейса

TextMenu (Текстовое меню)

4zz.png

Шаблон объекта TextMenu для XML

<****TextMenu  defaultIndex= “some integer” style = 
“numbered/none/radio”

   Beep = “yes/no” Timeout = “some integer” LockIn = “yes/no”

WrapList = “yes/no”>

   <Title wrap = “yes/no” showlistcount="yes/no">Menu

Title</Title>

   <MenuItem>     <Prompt>First Choice</Prompt>

   		<URI>http://somepage.xml</URI>
   		<Dial>Number to dial</ Dial >
   		<Selection>Selection</ Selection >
   </ MenuItem >
   <!- Additional items (up to 30) - ->
   <!-Additional Softkey Items may be added (softkey phones) - ->
  		 </****TextMenu >

название “TextMenu” можно заменить другим по необходимости.

Пример XML файла с объектом TextMenu

  <?xml version="1.0" encoding="ISO-8859-1"?>
  <IPPhoneTextMenu style="radio"  Beep="yes"  wrapList="yes"  
 Timeout=”30”  LockIn="yes">
  <Title Wrap=”yes”Showlistcount=”no”>Phone Services </Title>
  <MenuItem>
      <Prompt>Area Code</Prompt>
      <URI>http://10.1.0.105/aastra/area/area.php</URI>
      <Dial>220</ Dial >
    </MenuItem>
  <MenuItem>
 <Prompt>Ask Google</Prompt>
 <URI>http:// 10.1.0.105/aastra/google/google.php?user=</URI>
 <Dial>220</ Dial >
     </MenuItem>
   <MenuItem>
  <Prompt>CNN News</Prompt>
  <URI>http:// 10.1.0.105/aastra/rss/rss.php?feed=cnn</URI>
  <Dial>220</ Dial >
     </MenuItem>
 </IPPhoneTextMenu>

XML спецификация для TextMenu

XML название Тип Значение Описание
IPPhoneTextMenu Compulsory (Обязательный) None(нет) Root Label (основной тэг)
DefaultIndex Optional (необязательный) Integer(число) Индекс по умолчанию для меню = “1”
Style Optional “numbered”“none”

“radio” || Numbered(нумерованный): числа как индексы пунктов None(без): отображение без индексов для пунктов Radio(переключатель): переключатели в качестве индексов пунктов

Beep Optional “yes(Вкл)” “no(Выкл)” Рингтон
wrapList Optional “yes” “no” Использовать многострочность, если информация в списке не умещается в одну строку
Timeout Optional “integer” Возврат в режим ожидания по истечению времени.

По умолчанию 45

Lockin Optional “yes(да)” “no(нет)” Если значение “yes”, телефон не будет реагировать на нажатие клавиш softkey. Значение по умолчанию - “no”
InputType Optional “ABC” “abc” “123” “1Ab”“Abc” Настройка типа вводимых данных по умолчанию для доступа к XML браузеру
Title Optional String(Строка) Заголовок основного интерфейса меню
Wrap Optional “yes” “no” Использовать многострочность, если заголовок не умещается в одну строку.
Showlistcount Optional “yes” “no” Показывать номера страниц в списке
MenuItem Compulsory none Идентифицировать пункты меню
Prompt Compulsory String (символьная строка) Заголовок для пункта меню
URI Compulsory URI Событие действия для пункта меню
Dial Optional Telephone number (номер телефона/аккаунта) Если выбран пункт, будет вызван специальный номер
Selection Optional String Если URI для программной кнопки является адресом сервера, то в http-запрос будет добавлена эта строка “?selection=setting parameter” как “http://10.1.0.105/menu1.xml?selection=0&menu_pos=1”
Softkey Optional Xml Object Ссылка на объект программной кнопки

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

Идентификатор / Программной кнопки Название URI
1 Exit (Выход) Softkey:Exit
4 Select (Выбор) Softkey:Select

Спецификация кнопок для TextMenu в XML браузере

Название Описание Функции
Up/Down Перемещение Вверх/Вниз Перемещение по пунктам в меню
Digit key Цифры 1 - 9 Перемещению к конкретному пункту меню по номеру.
Select Программная кнопка,URI=”softkey:select ” Выбор действия по URI вида http запрос, набор номера и тд
Exit Программная кнопка,URI=”softkey:Exit ” Возврат к предыдущему интерфейсу XML. Или в режим ожидания.
OffHook/Linekey/Handfree Off hook(снять трубку)/line key(настраиваемая кнопка)/ handfree key(кнопка громкой связи) Если пункт в меню содержит метку для вызова, будет вызван специальный номер
Cancel Клавиша “X” на устройстве Возврат в режим ожидания
OK Клавиша “OK” на устройстве Если функция Lockin неактивна, клавиша Ok работает как кнопка Select
Dss key without sip trunk Кнопка DSS (включая модуль расширения) Если функция Lockin активна,кнопка Dss не будет работать.

TextScreen(Текст на экране)

5zz.png

XML шаблон объекта TextScreen

<****TextScreen doneAction = “URI” Beep = “yes/no” Timeout = “some integer”
LockIn = “yes/no”>
<Title wrap = “yes/no” showlistcount=”yes/no”>Screen Title</ Title >
<Text>The screen text goes here</Text>
<!-Additional Softkey Items may be added (softkey phones) - ->
</****TextScreen >

Пример XML файла с объектом TextScreen

<?xml version="1.0" encoding="ISO-8859-1"?>
<IPPhoneTextScreen doneAction="http://10.1.0.105/cancel.php" Timeout="5" 
LockIn="no" Beep="yes">
<title wrap="yes">Screen Title </Title>
<Text>The screen text goes here</Text>
</IPPhoneTextScreen>

XML спецификация объекта TextScreen

XML название Тип Значение Описание
IPPhoneTextScreen Compulsory (обязательный) Нет Основной тэг
Beep Optional (необязательный) “yes(вкл)”“no(выкл)” Рингтон
doneAction Optional URI Выполнение специальной URI, когда выбрана кнопка

Done(Выполнить)

Timeout Optional “integer(число)” Возврат в режим ожидания после таймаута.

По умолчанию 45

Lockin Optional “yes(вкл)”“no(выкл)” Если значение “yes”, нажатия клавиш на устройстве не будут восприниматься. По умолчанию “no”
InputType Optional “ABC”“abc”“123”“1Ab”“Abc” Задает основной тип вводимых данных для XML браузера
Title Optional String (символьная строка) Название заголовка
Wrap Optional “yes”“no” Использование нескольких строк, когда информация не умещается в одну.
Text Compulsory String Текст
Softkey Optional Xml Object Ссылка на объект программируемой кнопки

Если XML файл объекта TextScreen не содержит, программируемая кнопка выглядит следующим образом:

Индекс кнопки Название URI
1 Exit(выход) Softkey:Exit

Спецификация функций кнопок в XML интерфейсе TextScreen

Название кнопки Описание кнопки Функции
Up/Down Up/Down Up(Вверх)/Down(Вниз) Выбор элемента в меню
Digit key Цифра 1 - 9 Переход к пункту в меню по номеру.
Exit Программируемая кнопка,URI=”softkey:Exit ” Возврат к предыдущему интерфейсу xml, или возврат в режим ожидания.
OffHook/Linekey/Handfree Off hook(снять трубку)/line key(настраиваемая кнопка)/ handfree key(кнопка громкой связи) Если пункт в меню содержит метку для вызова, при выборе его будет набран специальный номер
Cancel Клавиша “X” на устройстве Возврат в режим ожидания
OK OK Клавиша “OK” на устройстве Действие для завершения(напр. Вызова)

InputScreen (Ввод данных с их отображением на экране)

6zz.png

XML шаблон объекта InputScreen

<****InputScreen type = “IP/string/number/timeUS/timeInt/dateUS/dateInt”  
password = “yes/no”
editable = “yes/no”  Beep = “yes/no”  Timeout = “some integer” LockIn = “yes/no” 
defaultIndex = “some integer 1 to 6”  displayMode = “normal/condensed” 
inputLanguage = “English/French/German/Italian/Spanish”>
<Title wrap = “yes/no” showlistcount=”yes/no”>Title string</Title>
<Prompt>Guidance for the input</Prompt>
<URL>Target receiving the input</URL>
<Parameteremptyable="yes"> name of the parameter add to URL</Parameter>
<Default>Default Value (1)</Default>
<InputField type = “IP/string/number/timeUS/timeInt/dateUS/dateInt/empty”password 
= “yes/no”
editable = “yes/no”>
<Prompt>Guidance for the input</Prompt>
<URL>Target receiving the input</URL>
<Parameter> parameter name add to URL</Parameter>
<Default>Default Value</Default>
<Selection>Selection</Selection>
<!-Additional Softkey Items may be added (softkey phones) - ->
</InputField>
<!-Additional Input fields Items may be added - ->
<!-Additional Softkey Items may be added (softkey phones) - ->
</****InputScreen >

Пример XML файла для объекта TextScreen

<IPPhoneInputScreen type="IP" Timeout="5" Beep="no">
<Title>Proxy Server</Title>
<Prompt>Server IP:</Prompt>
<URL>http://10.1.0.105/menu.php</URL>
<Parameter>proxy</Parameter>
<Default>10.1.0.105</Default>
</IPPhoneInputScreen>

XML спецификация объекта InputScreen

По умолчанию:

Спецификация кнопок в интерфейсе XML объекта inputScreen.

Название кнопки Описание кнопки Функция
Up/Down Перемещение Up(Вверх)/Down(Вниз)
Left/Right Перемещение Left(Влево)/Right(Вправо)
Digit key Цифры 1 - 9 Переход к пункту в меню по номеру
BackSpace Программируемая кнопка, URI=”SoftKey:Backspace” Удалить введенную строку
Submit Программируемая кнопка, URI=”SoftKey:Submit” Вызов события по URI
2aB Программируемая кнопка, URI=”SoftKey:ChangeMode” Переключение типа вводимых данных между “2aB” ”ABC”“abc” и “123”
OffHook/Linekey/Handfree Off hook(снять трубку)/line key(настраиваемая кнопка)/ handfree key(кнопка громкой связи) Если пункт в меню содержит метку для вызова, при выборе будет набран специальный номер
Cancel Клавиша X на устройстве Возврат в режим ожидания
OK Клавиша “OK” на устройстве Если Lockin не включен, клавиша OK работает как кнопка Select. Если включен, нажатие клавиши не распознается
Клавиша DSS без sip транка Клавиша DSS Если Lockin включен, клавиша DSS работать не будет

XML спецификация объекта InputScreen

1zzz.png

Если XML файл объекта Input screen не содержит спецификации для кнопок, по умолчанию:

Индекс кнопки Название URI
1 Back(назад) Softkey:Exit
2 123 SoftKey:Change mode
3 Delete(удалить) SoftKey:Backspace
4 Save (сохранить) SoftKey: Submit

Спецификация кнопок для объекта inputScreen.

Название кнопки Описание кнопки Функция
Up/Down Перемещение Up(Вверх)/Down(Вниз)
Left/Right Перемещение Left(Влево)/Right(Вправо)
Digit key Цифры 1 - 9 Переход к пункту в меню по номеру
BackSpace Программируемая кнопка, URI=”SoftKey:Backspace” Удалить введенную строку
Submit Программируемая кнопка, URI=”SoftKey:Submit” Вызов события по URI
2aB Программируемая кнопка, URI=”SoftKey:ChangeMode” Переключение типа вводимых данных между “2aB” ”ABC”“abc” и “123”
OffHook/Linekey/Handfree Off hook(снять трубку)/line key(настраиваемая кнопка)/ handfree key(кнопка громкой связи) Если пункт в меню содержит метку для вызова, при выборе будет набран специальный номер
Cancel Клавиша X на устройстве Возврат в режим ожидания
OK Клавиша “OK” на устройстве Если Lockin не включен, клавиша OK работает как кнопка Select. Если включен, нажатие клавиши не распознается
Клавиша DSS без sip транка Клавиша DSS Если Lockin включен, клавиша DSS работать не будет.

Directory(Каталог)

7zz.png

XML шаблон объекта Directory

<****Directory Next = “some URI” Previous = “some URI” Selection=”some URI” Beep 
= “yes/no”
Timeout = “some integer” LockIn = “yes/no”>
<Title wrap = “yes/no”showlistcount=”yes/no”>Directory Title</Title>
<MenuItem>
<Prompt>Contact Name</Prompt>
<URI>number</URI>
</MenuItem>
<!-Additional Menu Items may be added - ->
<!-Additional Softkey Items may be added - ->
</****Directory>

Пример XML файла объекта Directory

<?xml version="1.0" encoding="utf-8" ?>
  <IPPhoneDirectory defaultIndex="1"  style="none"Beep="no" wrapList="no" 
 Next="http://192.168.1.98:80/?action=getphonebook&menu=search"
  Selection="http://192.168.1.98:80/?action=getphonebook&">
  <DirectoryEntry>
  <Name>User_202</Name>
  <Telephone>202</Telephone>
  <Presence>INCOMING</Presence>
  <Selection>detail=202</Selection>
  </DirectoryEntry>
 <DirectoryEntry>
   <Name>User_201</Name>
   <Presence>INCOMING</Presence>
   <URI>http://192.168.1.98:80/?action=getphobenook&menu=selectnumber</URI>
   </DirectoryEntry>
   .........
 <SoftKey index="1">
<Label>Exit</Label>
<URI>SoftKey:Exit</URI>
</SoftKey>
 <SoftKey index="2">
<Label>Search</Label>
<URI>SoftKey:Next</URI>
</SoftKey>  (*)
  <SoftKey index="3">
<Label>Detail</Label>
<URI>SoftKey:Select</URI>
</SoftKey> (**)
 <SoftKey index="4">
<Label>Enter</Label><URI>SoftKey:Dial</URI></SoftKey>     (***)
</IPPhoneDirectory>

XML спецификация для Directory

Название Тип Значение Описание
IPPhoneDirectory Compulsory (Обязательный) Нет Основной тэг
Next Optional (Необязательной) URI Настройка URI действия для кнопки “Next(Следующее)”
Previous Optional URI Настройка URI действия для кнопки “Previous(Предыдущее)”
Selection Optional Целочисленное число Настройка URI действия для кнопки “Select(Выбрать)”
Beep Optional “yes(вкл)”“no(выкл)” Рингтон
Timeout Optional Целочисленное число Возврат в режим ожидания после таймаута. По умолчанию 45
Lockin Optional “yes(вкл)”“no(выкл)” Если “yes”, телефон не будет реагировать на нажатие клавиш. По умолчанию “no”
InputType Optional “ABC”“abc”“123”“1Ab”“Abc” Задаёт основной тип вводимых данных для XML браузера
Title Compulsory Символьная строка Заголовок для директории
Wrap Optional Yes/No Использовать несколько строк, если текст не умещается в одну
MenuItem Необязательный Нет Индекс для пункта меню(значение:1-15) Prompt Обязательный Символьная строка Заголовок для пункта меню URI Обязательный URI Действие для пункта меню Softkey Необязательный Xml объект Ссылка на объект

Спецификация кнопок по умолчанию:

Индекс кнопки Название URI
1 Exit(Выход) Softkey:Exit
2 Next(Следующее) SoftKey:Next
3 Select(Выбрать) SoftKey:Select
4 Dial(Вызов) SoftKey: Dial

Спецификация кнопок для объекта directory.

Название Описание Функция
Up/Down Перемещение вверх/вниз
Digit key Цифра от 1 - 9 Переход к пункту меню по номеру.
Dial Кнопка URI=”SoftKey:Submit” Вызов номера из пункта меню
Previous Кнопка URI=”SoftKey:ChangeMode” Вызов функции «предыдущее»
Next Кнопка URI=”SoftKey:Next” Вызов функции «следующее»
Select Кнопка URI=”SoftKey:Select” Выбор пункта
Exit Кнопка URI=”SoftKey:Exit” Возврат к предыдущему интерфейсу XML
OffHook/Linekey/Handfree Повесить трубку/Клавиша/ Кнопка громкой связи Вызов
Cancel Клавиша“X” Возврат в режим ожидания
OK Клавиша “OK” Если Lockin выкл, клавиша OK работает как кнопка выбора
Dss key without sip trunk Клавиша DSS Если Lockin вкл,клавиша DSS не распознается