Материал из for iRidium developers
Перейти к: навигация, поиск
Other languages:
English • ‎русский

Проект на панели управления можно обновить без iRidium Transfer, заранее не закладывая эту возможность. Нужно сформировать НТТР ссылку на проект, добавить специальную URL схему и сделать сыслку доступной для панели управления: опубликовать на сайте, послать по почте, распечатать как QR код.

Специальная URL схема - команда запуска приложения iRidium нужна для того, чтобы НТТР ссылка на проект открылась именно в iRidium, а не в браузере.

URL схемы запуска приложения работают только на iOS и Android. Для обновления проекта на Windows и Mac, подходит только метод IR.DownLoadProject() в JavaScript проекта на панели управления.


Создать ссылку и URL схему

iRidium может загрузить проект только по HTTP или HTTPs, при условии, что переход по ссылке не требует автоматической переадресации на другой сервер. Поэтому удобнее всего хранить проекты на Google Drive и Amazon S3. Вы можете использовать и локальный сервер.


1 Подготовьте проект в iRidium Transfer:

CresteEXEwithTransferGetGUI.png

1. Нажмите клавишу "Создать"

2. Выберите файл лицензии для панели управления, где будет работать проект:

  • Device License - для каждой панели нужно создать свою ссылку, т.к. лицензии в проекте должны быть разные
  • Site License - можно будет загрузить и использовать на любой панели управления
  • Можно загрузить проект без лицензии


3. Скопируйте файл main.irpz из открывшейся папки.

Только файл main.irpz нужно загрузить в хранилище!


2 Загрузите проект на Google Drive или Amazon S3

ИНСТРУКЦИЯ для GOOGLE DRIVE


Ссылку на проект с Google Drive нужно оформить так:

https://drive.google.com/uc?export=view&id=<FILE ID>

FILE ID скопируйте из настроек публичного доступа к файлу в режиме "Для всех, у кого есть ссылка":

HTTP Upload GoogleDrive.png

Пример готовой ссылки:

https://drive.google.com/uc?export=view&id=0BxVWN5pVkhJpYkQ4aXcxT3dUNzQ


Чтобы загрузить новую версию проекта, используйте менеджер версий (Manage Revisions) в Google Drive, тогда ссылка на проект будет оставаться постоянной

Размер файла на Google Drive не должен превышать 20 Мб

ИНСТРУКЦИЯ для AMAZON S3

Загрузите файл в хранилище Amazon S3, сделайте ссылку на него публичной: Make Public, скопируйте ссылку:

HTTP Upload AmazonS3.png

Пример готовой ссылки:

https://s3.amazonaws.com/iRidiumWiki2.0/iRidiumTransfer/HTTP_Upload.irpz

использование других обменников не рекомендуется в связи с особенностями переадресации. Но, вы можете использовать любой HTTP(s) сервер, предоставляющий прямую ссылку на файл.


3 Создайте URL схему с полученной ссылкой. Она запустит i3 pro и скачает проект визуализации:

iridium://webupdate:0?https://s3.amazonaws.com/irmarketing/iPhone5_Metro.irpz

iridium:// - запустить i3 pro
webupdate:0? - обновить проект (без Мультипроектности)

webupdate:1? - обновить проект (с Мультипроектностью)
webupdate? - обновить проект (без Мультипроектности)

https://website.com/GUI.irpz - HTTP(s) ссылка на проект


4 Запустите URL схему в iRidium или в стороннем приложении, чтобы обновить проект.


URL схема в проекте iRidium

i3 pro может начать загрузку проекта по нажатию на кнопку, через скрипт или при считывании QR кода в приложении. Запустите URL схему обновления одним из способов:


Execute в редакторе макросов

Это самый простой способ выполнить URL схему при нажатии на кнопку в проекте. Работает на iOS и Android.

Execute(iridium://webupdate:0?https://s3.amazonaws.com/irmarketing/iPhone5_Metro.irpz)
IRidiumURLexecute.png


IR.Execute() в JavaScript

Метод IR.Execute() выполняется в JavaScript по любому событию: запуск приложения, нажатие на кнопку, команда от оборудования. Работает на iOS и Android.

function update () 
{
    IR.Execute("iridium://webupdate:0?https://s3.amazonaws.com/irmarketing/iPhone5_Metro.irpz");
}

Начать обновление можно, вызвав функцию update командой ScriptCall:

JSguide helloFunction.png


То же самое можно сделать, добавив вызов функций по какому-то событию в скриптах:

IR.AddListener(IR.EVENT_START, 0, function()
{
    update (); //update project when app starts
});


IR.DownLoadProject() в JavaScript

Альтернатива методу IR.Execute() в JavaScript, он обрабатывает не URL схему, а НТТР ссылку на проект!

Преимущества метода:

  • работает на iOS, Android, Windows, Mac
  • можно указать режим Мультипроектности и имя, с которым будет сохранен проект.


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

IR.DownLoadProject()

/** Auto-parsing of the link to the project: */
function parse_url(url) {
    var pattern = RegExp("^(([^:/?#]+):)?(//([^/?#]*))?([^?#]*)(\\?([^#]*))?(#(.*))?");
    var matches =  url.match(pattern);
    return {
        scheme: matches[2],
        authority: matches[4],
        path: matches[5],
        query: matches[7],
        fragment: matches[9]
    };
}
 
function HTTPUpdate(url)
{
   var parsed_url = parse_url(url);
   var downloader = IR.DownLoadProject(
                     {
                        type:parsed_url.scheme,
                        host:parsed_url.authority,
                        path:parsed_url.path + '?' + parsed_url.query,
                        multiproject: 0,   // 0 - Multiprojecting OFF, 1 - Multiprojecting ON
                        name: "New Project"   // Name of Downloaded Project (For multiprojecting: 1)
                     });
 }
 
////////////////// Recall the link by command "ScriptCall (Update_by_press)" ///////////////////////
function Update_by_press()
{
        // your link
        HTTPUpdate('https://s3.amazonaws.com/iRidiumWiki2.0/iRidiumTransfer/HTTP_Upload.irpz');
}

Начать обновление можно, вызвав функцию Update_by_press командой ScriptCall:

JSguide helloFunction.png

То же самое можно сделать, добавив вызов функций по какому-то событию в скриптах:

IR.AddListener(IR.EVENT_START, 0, function()
{
    Update_by_press (); // update when app starts
});


QR-ридер

Считыватель QR-кодов доступен при установке i3 pro с AppStore и GooglePlay. Вы можете добавить его в собственный проект визуализации.

Считыватель QR-кодов распознает НТТР(s) ссылку или URL схему iRidium и скачивает проект визуализации.


Чтобы создать QR-код из НТТР(s) ссылки или URL схемы, используйте один из бесплатных ресурсов в Интернете.

Чтобы добавить считыватель QR-кодов в интерфейс визуализации, скачайте и объедините его со своим проектом:

Считать QR-код может только Apple iOS и Android устройство, оснащенное встроенной камерой. Не добавляйте этот инструмент в проекты для Windows и Mac.


URL схема в стороннем приложении

i3 pro запустится и начнет загрузку проекта по нажатию на гиперссылку с URL схемой обновления iRidium.


URL схемы работают только на iOS и Android устройствах. Для Windows и Mac используйте метод IR.DownloadProject() внутри приложения iRidium.

Запустить URL схему iRidium можно как любую ссылку:

  • отправьте URL схему по почте как гиперссылку
  • разместите URL схему на сайте как гиперссылку
  • скопируйте как текст и вставьте схему в поле адреса в интернет-браузере, нажмите "Перейти"
  • создайте QR-код с URL схемой, разместите онлайн или распечатайте. Считайте и запустите схему с помощью любого приложения с функцией распознавания QR-кодов.


Когда URL схема на панели управления запущена любым способом, приложение откроется и начнет скачивание проекта с удаленного ресурса. После скачивания, i3 pro перезагрузится и откроет новый проект визуализации.


Используйте на панели управления iOS и Android, где установлен i3 pro

URL схема в QR-коде (считайте любым приложением)

QRcodeSample.png

URL схема в гиперссылке (нажмите на ссылку)

СКАЧАТЬ ПРОЕКТ



Обновление через iRidium Transfer

Это классический механизм обновления проектов, который предусматривает загрузку проекта с вашего ПК на удаленную панель управления.


1 Настройте iRidium Transfer на ПК

Добавьте панель управления в список Transfer - для этого нужен её HWID. Получите HWID, нажав кнопку "Copy HWID" в приложении iRidium, только что установленном с AppStore или GooglePlay.

Transfer remote update 1.png


2 Настройте маршрутизатор, к которому подключен ПК с Transfer

Настройте проброс порта 10000 - это порт, через который Transfer отправляет проекты на панели управления.

Узнать публичный IP-адрес своего маршрутизатора можно при помощи онлайн-сервисов, например Яндекс.Интернет.


3 Настройте i3 pro на панели управления

Нужно указать приложению, откуда загружать проект. Для этого:

WinApp Settings1.png
  1. Запустите i3 pro на панели управления, в течение 10 сек. удерживайте палец или курсор мыши в любом месте проекта, где нет активных кнопок
  2. Введите пароль 2007 для доступа к настройкам
  3. Перейдите во вкладку Update, посавтьте галочку в поле "Enable"
  4. В поле "Host" укажите публичный IP-адрес маршрутизатора, к которому подключен ПК с Transfer
  5. Нажмите "Update Now", чтобы запустить обновление
  6. Уберите галочку в поле "Enable", когда проект обновлен