AVOSUPPORT

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
Downloads

====== Web API Demo ======

//These are the first encounters with Titan's Web API. Meanwhile this has very much evolved and can be found [[webapi:start|in a separate section here]]. However this demo is still here for documentation purposes.//

==== Deutsch/German ====

[[#english|English version below]].

Seit Titan Version 10 (Sommer 2016) verfügen die Avolites Lichtpulte über eine Web-API: dies ist eine Protokolldefinition, um viele Aspekte des Pultes über einfache HTTP-Requests zu steuern. Damit wird es möglich, anwenderspezifisch massgeschneiderte Bedienoberflächen zu konzipieren und nach eigenem Gutdünken zu gestalten. Dabei ist das eher Web- als Lichtdesign, und ein gewisses Grundverständnis zu HTML, Javascript und eventuell noch weiteren Web-Techniken ist unbedingte Voraussetzung.

Momentan gibt es dazu die [[https://api.avolites.com|Avolites-Dokumentation der verfügbaren Befehle]] sowie [[https://www.youtube.com/watch?v=kz_jUGAY4_U|ein erstes Video]]. Jedoch ist damit allenfalls ein sehr rudimentäres Testen einzelner Aufrufe möglich. Insbesondere gewinnt man damit kaum einen Eindruck davon, was mit dieser Schnittstelle eigentlich möglich ist.

Um sowohl das Testen und die ersten Schritte auf diesem Weg zu vereinfachen als auch einen ersten Eindruck zu vermitteln, wie damit rasch eigene Bedienkonzepte entstehen können, wurde die Web-API Demosite entwickelt: ein schlankes Werkzeug ohne unnötigen Ballast, mit dem rasch erste Erfolge erzielt werden können. Sehr gern kann diese in weiteren eigenen Projekten verwendet werden.

Derzeit gibt es folgende Daten dazu - **die Dateien wurden am 12.10.2016 aktualisiert**:

  * die eigentliche [[https://avosupport.de/downloads/webapi/index.htm|Web-API]]: eine einzelne HTML-Datei, die gleich alles erforderliche CSS und Javascript enthält - kann auch direkt online verwendet werden
  * eine umfangreiche - englische - [[https://avosupport.de/downloads/webapi/help/index.htm|Hilfedatei]]
  * eine [[https://avosupport.de/downloads/webapi/release.txt|Liste der Releases]]
  * ein exemplarischer [[https://avosupport.de/downloads/webapi/export.txt|Export]] der vorgenommenen Einstellungen
  * eine exemplarische [[https://avosupport.de/downloads/webapi/commands.txt|Übersicht möglicher Steuerbefehle]] - die gleichen Befehle, die auch im o.g. Video zur Anwendung kommen
  * alles gepackt in einem [[https://avosupport.de/downloads/webapi/WebAPI_Demo.zip|Zip-Archiv]]: einfach downloaden, entpacken, und die enthaltene index.htm im Browser öffnen
  * ein deutsches [[https://www.youtube.com/watch?v=tUeU8tfd5h4|Youtube-Video]] zeigt die Verwendung dieser Demo-Website, [[https://www.youtube.com/watch?v=2M-yDiZzd0o|ein weiteres Video]] erklärt die neuesten Änderungen (12.10.2016)

Dies ist ausdrücklich als Anregung für eigene Projekte und als 'Hilfe zur Selbsthilfe' gedacht: ein umfangreicher Support etwa für eigene Projekte ist nicht kostenlos möglich. Gern stehen wir jedoch für einzelne Fragen zur Verfügung. Und weitere Anregungen und Vorschläge werden selbstverständlich gern aufgenommen. 

<fs large>**Wichtiger Hinweis: die Web-API steht auf allen Pulten vom Titan Mobile an aufwärts zur Verfügung, nicht aber auf dem Titan One und dem Titan Simulator.**</fs>

Einige Screenshots als erster Eindruck:


{{:downloads:total_900.png?200|}}  {{:downloads:example_900.png?200|}}  {{:downloads:help_900.png?200|}}


----

==== English ====

Since the release of Titan version 10 (summer 2016) Avolites lighting consoles come with a Web API: this is a protocol definition which allows to control the lighting desk by simple HTTP requests. This way it is possible to create own, customized user interfaces in any layout you may think of. In fact this is more web design than lighting design, and a good knowledge of HTML, Javascript and other web technologies and programming languages is compulsory.

First public files were the [[https://api.avolites.com|Avolites web API documentation of the available commands]] and [[https://www.youtube.com/watch?v=kz_jUGAY4_U|a first video]]. However, this approach, while demonstrating the working principle, allows only for a very basic testing of single requests. Furthermore it is almost impossible to get an impression of what is really possible with this powerful interface.

In order to allow for an easier and quicker testing, as well as to demonstrate how quickly and easily a neat user interface can be created, something else was required: the Web-API demo site. This is a lean tool, without any unnecessary overhead, targeting at quick first results. And you can freely use this tool in your own projects.

Currently these files are available - **latest update: 12.10.2016**:

  * the actual [[https://avosupport.de/downloads/webapi/index.htm|Web-API]]: one single HTML file which also holds all required CSS and Javascript
  * an extensive - english - [[https://avosupport.de/downloads/webapi/help/index.htm|online help]]
  * a [[https://avosupport.de/downloads/webapi/release.txt|release document]]
  * an example [[https://avosupport.de/downloads/webapi/export.txt|export]]
  * a [[https://avosupport.de/downloads/webapi/commands.txt|list of some frequently used commands]] - the same commands which were used and shown in the a.m. video
  * all packed together in one [[https://avosupport.de/downloads/webapi/WebAPI_Demo.zip|Zip archive]]: just download, unzip, and open the included index.htm in your web Browser
  * an english [[https://www.youtube.com/watch?v=jfUB_QBFW_k|Youtube video]] explains how to use this demo website, [[https://www.youtube.com/watch?v=P80Swn1B-pQ|another video]] explains the latest changes

This is to be regarded as example, and as help to get you started with your own ideas. We cannot provide comprehensive support for any private project, in particular in implementing your own, customized, solution. However, we are happy to answer any question regarding the general use of the commands, and the use of this demo. And if you want to contribute an idea or an improvement, then we look forward to hearing from you.

<fs large>**Important: Avolites Web-API is available only on Avolites lighting consoles from the Titan Mobile and above. It is not available for the Titan One and the Simulator.**</fs>

Some screenshots:

{{:downloads:total_900.png?200|}}  {{:downloads:example_900.png?200|}}  {{:downloads:help_900.png?200|}}