RoarAudio/Programmieren/Intro

Dies ist eine minimale Einleitung zur Programmierung mittels der RoarAudio Standard Bibliotheken.

Diese Anleitung setzt grundlegendes Verständnis zur Funktionsweise von RoarAudio voraus.

Dieses Dokument beschreibt die Standard API. Für sehr einfache Programme mag es angebracht sein die Simple API zu verwenden.

Verbindung zum Server

In aller Regel muss zu Beginn eine Verbindung zum Server aufgenommen werden. Dazu wird ein Objekt für die Verbindung angelegt und dies dann mit dem Server verbunden. Ist die Arbeit getan so wird die Verbindung wieder Beendet. Die Verbindung sollte aber offen gehalten werden sofern in absehbarer Zeit sonst eine neue Verbindung aufgebaut werden müsste. (Etwa sollte sie nicht bei einem Lied Wechsel in einem Player erst abgebaut und dann erneut Aufgebaut werden, sondern bestehen bleiben solange der Player nicht beendet wird durch den Benutzer).

Öffnen eines Steuerkanals:

struct roar_connection con; // Steuer Verbindung

if ( roar_simple_connect(&con, NULL, "Klient Name")) == -1 ) {
 return -1;
}

In diesem Beispiel wird ein Objekt names con erzeugt und mit dem Standard Server (NULL) verbunden. Wird anstatt NULL ein String übergeben so wird dieser als Server Name/Adresse verwendet. Das letzte Argument ist der Name des neuen Klienten. Dieser wird beispielsweise durch roarctl angezeigt.

Ist die Arbeit getan so kann die Verbindung einfach durch roar_disconnect() wieder geschlossen werden:

roar_disconnect(&con);

Erstellen eines Streams

...

Siehe Auch

• RoarAudio

Weblinks

Offizielle Webpräsenz „RoarAudio/Programmieren/Intro”

UUGRN-Wiki verbessern („Stub”)

Dieser Artikel ist leider sehr kurz. Also: Sei mutig und mache aus ihm bitte einen guten Artikel, wenn du mehr zum Thema „RoarAudio/Programmieren/Intro” weißt.