Ein BeeWi-Auto mit Xamarin iOS steuern

Falls dich die Android-Variante interessiert: Dieses Thema habe ich bereits in Ein BeeWi Car mit Xamarin.Android steuern behandelt. Bevor ich anfange: Das ist mein erster englischer Artikel gewesen, daher bekommt die deutsche Version hier nun ihren Platz im de-Verzeichnis.

Projekt erstellen

Öffne Xamarin Studio und erstelle ein neues iOS-Projekt mit der Vorlage deiner Wahl. Ich verwende und empfehle die Vorlage Single View Application aus dem Ordner Unified API iPhone. Die neue Unified API brachte damals neben einigen weiteren Verbesserungen 32-Bit- und 64-Bit-Unterstützung mit, die Apple ab Februar 2015 für alle Apps verlangte.

Benutzeroberfläche

Im neu angelegten Projekt findest du die Datei Mainstoryboard.storyboard. Ein Doppelklick darauf öffnet den Xamarin.iOS-UI-Designer. Gestalte die Oberfläche so, wie du möchtest, aber denke daran, dass wir mindestens die folgenden Befehle senden können müssen:

• vorwärts
• rückwärts
• links
• rechts

Wie man an meiner Oberfläche sieht, bin ich kein Designer.

External Accessory Framework

Sobald es eine Oberfläche gibt, über die Befehle an das BeeWi-Auto gesendet werden können, ist es Zeit, die Kommunikation zwischen Spielzeug und Gerät umzusetzen. iOS stellt dafür verschiedene APIs bereit, je nachdem, was man erreichen möchte.

In diesem Fall brauchen wir das External Accessory Framework. Ein Zubehörteil repräsentiert in iOS ein Gerät, hier also das Auto, das mit einem iPad oder iPhone gekoppelt ist. Da mehrere Zubehörteile verbunden sein könnten, müssen wir zunächst das richtige finden.

var connectedAccessories = EAAccessoryManager.SharedAccessoryManager.ConnectedAccessories;
EAAccessory beeWiCar = null;

foreach (var accessory in connectedAccessories)
{
    foreach (var protocolString in accessory.ProtocolStrings)
	{
		protocolString.Contains("com.beewi.controlleur");
		beeWiCar = accessory;
		break;
	}
}

Nachdem wir das Auto gefunden haben, müssen wir eine Kommunikationssitzung öffnen. Diese Sitzung wird im External Accessory Framework durch EASession repräsentiert. Sie erlaubt es, Daten vom Zubehör zu lesen oder dorthin zu schreiben. Um eine Sitzung zu starten, übergibst du dem Konstruktor von EASession das Zubehör und das Protokoll. Anschließend können die Streams zum Lesen und Schreiben geöffnet werden.

if (beeWiCar != null)
{
	try
    {
		session = new EASession(beeWiCar, "com.beewi.controlleur");
		session.Accessory.Disconnected += delegate
		{
			CloseSession();
			new UIAlertView("BeeWi Car", "BeeWi car disconnected", null, "OK").Show();
		};

        session.InputStream.Schedule(NSRunLoop.Current, NSRunLoop.NSDefaultRunLoopMode);
        session.InputStream.Open();

        session.OutputStream.Schedule(NSRunLoop.Current, NSRunLoop.NSDefaultRunLoopMode);
		session.OutputStream.Open();
    }
	catch (Exception ex)
	{
		new UIAlertView("BeeWi Car", "Ups something went wrong.", null, "OK").Show();
    }
}
else
{
	new UIAlertView("BeeWi Car", "No BeeWi car connected", null, "OK").Show();
}

Daten senden

Jetzt, da die Verbindung zum BeeWi-Auto steht, können wir die Buttons verdrahten, zum Beispiel so:

btnForward.TouchDown += delegate
{
    SendCommand(BeeWiCarCommands.Forward_Go);
};

btnForward.TouchUpInside += delegate
{
    SendCommand(BeeWiCarCommands.Forward_Stop);
};

Jedes Mal, wenn du einen Button drückst, wird der dazugehörige Befehl über die Methode SendCommand verschickt. Wir müssen aber auch immer ein Signal senden, das dem Auto sagt, dass es wieder stoppen soll. Das sollte man im Hinterkopf behalten.

Die Methode SendCommand prüft zunächst, ob die Sitzung noch aktiv ist und das Auto verbunden ist, und sendet danach den Befehl.

void SendCommand(BeeWiCarCommands command)
{
	try
	{
		if (session == null)
	    {
            new UIAlertView("BeeWi Car", "No connection established", null, "OK").Show();
            return;
		}

	    if (!session.Accessory.Connected)
        {
			new UIAlertView("BeeWi Car", "Car not connected", null, "OK").Show();
			return;
		}

		session.OutputStream.Write(new byte[]{ (byte)command }, 0, 1);
	}
    catch (Exception ex)
    {
		new UIAlertView("BeeWi Car", ex.Message, null, "OK").Show();
	}
}

Protokoll in der Info.plist registrieren

Eine letzte Sache musst du noch tun, damit du das BeeWi-Auto mit deinem iPhone oder iPad steuern kannst: Registriere das Protokoll com.beewi.controlleur in deiner App. Öffne dazu die Datei Info.plist, wechsle in den Reiter Source und füge einen neuen Eintrag vom Typ Supported external accessory protocols hinzu. Als Wert trägst du com.beewi.controlleur ein.

Fazit

Mit diesem kleinen Spielzeug zu experimentieren und es über eine selbst geschriebene App zu steuern, macht wirklich Spaß. Und mit dem External Accessory Framework ist es erstaunlich einfach, auf iOS mit verbundenen Geräten zu arbeiten. Das ist auch ein guter Einstieg, um mehr über Sensoren und Gerätesteuerung zu lernen. Stell dir zum Beispiel vor, du würdest das Auto per Touch oder über die Bewegung des Telefons steuern. Das wäre Stoff für einen weiteren Artikel.

Den vollständigen Code findest du auf bitbucket.

FAQ