Настройка XML браузера
XML браузер это простой браузер на базе языка XML и сервисов http/https для SIP телефона. Языки программирования такие, как Php, javascript могут быть использованы на сервере для генерации подходящих XML файлов для SIP телефона для их загрузки через http/https. С помощью XML браузера можно реализовывать персонализированную конфигурацию, например, проверять прогноз погоды, акции, дату / время или контакт; поиск в google; воспроизводить музыку или настраивать другие подобные устройства
XML браузер поддерживает следующие типы XML файлов：
1.TextMenu: это меню в текстовом формате.
2.TextScreen: отображение подробной информации в виде текста.
3.InputScreen: Ввод информации от пользователя, похоже на интерфейс регистрации аккаунта.
4.Directory: Загрузка телефонной книги.
Содержание
- 1 Настройка XML браузера
- 2 Настройка сервера XML браузера
- 3 Настройка XML браузера на экране устройства
- 4 Формат XML файла
- 5 XML спецификация для TextMenu
- 6 TextScreen(Текст на экране)
- 7 XML спецификация объекта TextScreen
- 8 XML шаблон объекта InputScreen
- 9 XML спецификация объекта InputScreen
- 10 Directory(Каталог)
Настройка XML браузера
Настройка кнопки XML Браузера через веб интерфейс 1.Войдите по IP устройства в веб интерфейс;
2.Выберите любую кнопку line key, soft key, function key или DSS key в разделе Phone(Телефон)→Key/Display(Кнопки/Отображение) или DSS Key.Укажите тип как XML браузер, введите корректный URL для xml файлов в поле Value(значение) и нажмите submit для подтверждения.
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:
3.Запустите tftp32.exe.
4.Введите URL для XML файлов в поле value для завершения настроек
Настройка XML браузера на экране устройства
1.Откройте Menu(Меню) → Features(Функции) → Programmable Keys(Программируемые кнопки) → Line Keys/Soft Keys/Function Keys/DSS keys.
2.Выберите XML браузер в качестве типа и введите URL сервера, как показано ниже
3.В интерфейсе ожидания нажмите кнопку XML браузера для доступа к XML файлам.
Формат XML файла
Нажмите кнопку XML браузера для входа в интерфейс XML. Ниже показаны 4 типа интерфейса
TextMenu (Текстовое меню)
Шаблон объекта 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(Текст на экране)
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 (Ввод данных с их отображением на экране)
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
Если 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(Каталог)
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 не распознается |
