Android SDK

Pro Android vývojáře je připravená miniaturní open-source knihovna, která obstarává veškerou komunikaci s Antelli a stačí implementovat jen pár abstraktních metod.

Můžete si vybrat, jestli vytvoříte samostatný plugin a nebo můžete knihovnu integrovat do svojí existující aplikace a rozšířit jí tak o hlasovou interakci. Antelli pak sama pozná, které nainstalované aplikace obsahují její SDK a dokáží tak odpovídat na dotazy uživatele.

Začínáme

Budete potřebovat aktuální verzi Android Studia, k dispozici je jednoduchý sample projekt, ve kterém najdete ukázku všech možností, které Antelli SDK nabízí. Jak už bylo zmíněno, jsou dvě možnosti, jak pro Antelli vyvíjet

Na testování vašeho pluginu vždy používejte aktuální verzi Antelli.

1) Samostatný Plugin

  1. Stáhněte si Sample projekt: https://github.com/stepansonsky/antelli-sdk-sample
  2. Otevřete Sample v Android Studiu
  3. Pokračujte na dokumentaci.

2) Integrace Antelli SDK do vaší aplikace

  1. Do dependencies v build.gradle přidejte:
    compile 'io.antelli:sdk:1.2.1'
  2. Vytvořte si třídu, která bude dědit od AntelliPlugin:

    public class MyPlugin extends AntelliPlugin { ... }
  3. Do Manifestu přidejte následující Service.
    Parametr „samples“ jsou příklady otázek oddělené středníkem, „languages“ jsou podporované jazyky, oddělené středníkem. Email uveďte takový, kde vás uživatelé budou moci kontaktovat a hlásit případné chyby. Parametr „settings“ definuje, jestli váš plugin bude mít nějakou Activity s nastavením. Parametr api_version neměňte.

    <service android:name=".MyPlugin">
        <intent-filter>
            <action android:name="io.antelli.assistant.ANSWER" />
        </intent-filter>
    
        <meta-data android:name="title" android:value="Název pluginu" />
        <meta-data android:name="author" android:value="Autor" />
        <meta-data android:name="email" android:value="vyvojar@pluginu.cz" />
        <meta-data android:name="description" android:value="Popis, co služba umí" />
        <meta-data android:name="samples" android:value="Ahoj světe; Hello world" />
        <meta-data android:name="settings" android:value="true" />
        <meta-data android:name="languages" android:value="cs" />
        <meta-data android:name="api_version" android:value="@string/antelli_sdk_version" />
    </service>
  4. Důležité! Pokud používáte ProGuard, přidejte toto pravidlo:
    -keepnames class io.antelli.sdk.**
  5. A to je vše, teď už stačí jen naimplementovat metody, pokračujte k dokumentaci.
Top