RoarAudio/Programmieren/Stream - Versionsgeschichte

Ph3-der-loewe: /* Mixer */ infos ueber die mixer funktionen

2010-02-08T12:48:46Z

Mixer: infos ueber die mixer funktionen

← Nächstältere Version		Version vom 8. Februar 2010, 12:48 Uhr
Zeile 99:		Zeile 99:
	== Mixer ==		== Mixer ==
	int roar_set_vol (struct roar_connection * con, int id, struct roar_mixer_settings * mixer, int channels);		int roar_set_vol (struct roar_connection * con, int id, struct roar_mixer_settings * mixer, int channels);

			Mit dieser Funktion können die Mixer werte für einen Stream gesetzt werden. Hierzu wird zu erst ein ''Mixer settings'' Objekt erzeugt. Dieses wird dann zusammen mit der Stream ID und der Anzahl der Kanäle, welche im Mixer Objekt gesetzt sind, übergeben. Stimmt die Anzahl der Kanäle nicht mit der des Streams überein so ist das Verhalten undefiniert.

	int roar_get_vol (struct roar_connection * con, int id, struct roar_mixer_settings * mixer, int * channels);		int roar_get_vol (struct roar_connection * con, int id, struct roar_mixer_settings * mixer, int * channels);

			Diese Funktion liest die aktuellen Mixer Einstellungen aus. Hierzu wird die Stream ID angeben. Die Funktion befüllt nun das Mixer Objekt und setzt die Anzahl der Kanäle in ''channels'' die der Stream, und somit auch das Mixer Objekt, beinhalten.

	== Streams erzeugen, verbinden und manipulieren ==		== Streams erzeugen, verbinden und manipulieren ==

Ph3-der-loewe: /* Streams erzeugen, verbinden und manipulieren */ infos zu den beiden funktionen

2010-02-08T12:43:24Z

Streams erzeugen, verbinden und manipulieren: infos zu den beiden funktionen

← Nächstältere Version		Version vom 8. Februar 2010, 12:43 Uhr
Zeile 103:		Zeile 103:
	== Streams erzeugen, verbinden und manipulieren ==		== Streams erzeugen, verbinden und manipulieren ==
	int roar_stream_attach_simple (struct roar_connection * con, struct roar_stream * s, int client);		int roar_stream_attach_simple (struct roar_connection * con, struct roar_stream * s, int client);

			Mittels dieser Funktion kann ein bereits existierender Stream einem neuen Klienten zugeordnet werden.

	int roar_kick (struct roar_connection * con, int type, int id);		int roar_kick (struct roar_connection * con, int type, int id);

			Mittels der Kick Funktion können verschiedenste Objekte vom Server getrennt werden. Unter anderem auch Streams. Um dies zu tun muss als ''type'' ''ROAR_OT_STREAM'' angegeben werden.

			Beispiel:
			ret = roar_kick(&con, ROAR_OT_STREAM, id);

	== Siehe Auch ==		== Siehe Auch ==

Ph3-der-loewe: /* Beispiel */ nen nettes komplettes beispiel

2010-02-08T12:15:11Z

Beispiel: nen nettes komplettes beispiel

← Nächstältere Version		Version vom 8. Februar 2010, 12:15 Uhr
Zeile 62:		Zeile 62:

	=== Beispiel ===		=== Beispiel ===
			#include <roaraudio.h>

			int main (void) {
			struct roar_connection con;
			struct roar_stream s;
			int i;
			int num;
			int id[ROAR_STREAMS_MAX];
			char name[1024];

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

			if ( (num = roar_list_streams(&con, id, ROAR_STREAMS_MAX)) == -1 ) {
			return 1;
			}

			for (i = 0; i < num; i++) {
			if ( roar_get_stream(&con, &s, id[i]) == -1 ) {
			return 1;
			}

			if ( roar_stream_get_name(&con, &s, name, 1024) == 0 ) {
			printf("Stream %i has name: %s\n", id[i], name);
			} else {
			printf("Stream %i has no name.\n", id[i]);
			}
			}

			roar_disconnect(&con);
			}

			'''Hinweis:''' Das Beispiel beinhaltet keine Fehler-Ausgaben und auch sonst nur eine minimale Fehler Behandlung. Diese sollte in einem echten Programm hinzugefügt werden.

	== Mixer ==		== Mixer ==

Ph3-der-loewe: /* Daten über Stream mit Server austauschen */

2010-02-08T11:57:28Z

Daten über Stream mit Server austauschen

@@ Zeile 28: / Zeile 28: @@
 == Daten über Stream mit Server austauschen ==
   int roar_stream_get_info (struct roar_connection * con, struct roar_stream * s, struct roar_stream_info * info);
   int roar_stream_get_name (struct roar_connection * con, struct roar_stream * s, char * name, size_t len);
   int roar_stream_set_flags (struct roar_connection * con, struct roar_stream * s, int flags, int reset);
- roar_list_streams(c,i,m) /* macro */
+Mittels dieser Funktion können flags auf dem Stream gesetzt werden (''reset'' = 0) oder wieder vom Stream entfernt werden (''reset'' = 1).
- int roar_get_stream   (struct roar_connection * con, struct roar_stream * stream, int id);
+Hinweis: Wirft die Funktion einen Fehler so ist der Zustand des Streams nur dann definiert sofern nur ein Flag gesetzt wurde. Wirft die Funktion einen Fehler so ist mindestens eines der Flags nicht gesetzt worden. Aus diesem grunde sollten kritische Flags (sync,hwmixer,...) einzeln gesetzt werden. Unkritische Flags (meta,cleanmeta,...) können in Gruppen gesetzt werden.
 == Mixer ==
   int roar_set_vol      (struct roar_connection * con, int id, struct roar_mixer_settings * mixer, int   channels);

Ph3-der-loewe: /* Arbeiten mit Stream Objekten */ formatirung

2010-02-08T11:35:39Z

Arbeiten mit Stream Objekten: formatirung

← Nächstältere Version		Version vom 8. Februar 2010, 11:35 Uhr
Zeile 4:		Zeile 4:
	int roar_stream_new_empty(struct roar_stream * s);		int roar_stream_new_empty(struct roar_stream * s);
	int roar_stream_new_by_id(struct roar_stream * s, int id);		int roar_stream_new_by_id(struct roar_stream * s, int id);
	int roar_stream_new (struct roar_stream * s, unsigned int rate, unsigned int channels, unsigned int bits, unsigned int codec);		int roar_stream_new (struct roar_stream * s,
			unsigned int rate, unsigned int channels, unsigned int bits,
			unsigned int codec);

	Diese Funktionen erzeugen ein Stream Objekt anhand der ihnen zur Verfügung gestellten Daten. ''roar_stream_new_by_id()'' ist vor allem zu verwenden um aus einer vorliegenden Stream ID ein Stream Objekt zu generieren um es für spätere API Call zus verwenden.		Diese Funktionen erzeugen ein Stream Objekt anhand der ihnen zur Verfügung gestellten Daten. ''roar_stream_new_by_id()'' ist vor allem zu verwenden um aus einer vorliegenden Stream ID ein Stream Objekt zu generieren um es für spätere API Call zus verwenden.


	int roar_stream_set_rel_id(struct roar_stream * s, int id);		int roar_stream_set_rel_id(struct roar_stream * s, int id);

Ph3-der-loewe: /* Arbeiten mit Stream Objekten */ beschreibung der lokalen manipulations funktionen

2010-02-08T11:33:09Z

Arbeiten mit Stream Objekten: beschreibung der lokalen manipulations funktionen

← Nächstältere Version		Version vom 8. Februar 2010, 11:33 Uhr
Zeile 2:		Zeile 2:

	== Arbeiten mit Stream Objekten ==		== Arbeiten mit Stream Objekten ==
			int roar_stream_new_empty(struct roar_stream * s);
			int roar_stream_new_by_id(struct roar_stream * s, int id);
	int roar_stream_new (struct roar_stream * s, unsigned int rate, unsigned int channels, unsigned int bits, unsigned int codec);		int roar_stream_new (struct roar_stream * s, unsigned int rate, unsigned int channels, unsigned int bits, unsigned int codec);

			Diese Funktionen erzeugen ein Stream Objekt anhand der ihnen zur Verfügung gestellten Daten. ''roar_stream_new_by_id()'' ist vor allem zu verwenden um aus einer vorliegenden Stream ID ein Stream Objekt zu generieren um es für spätere API Call zus verwenden.


	int roar_stream_set_rel_id(struct roar_stream * s, int id);		int roar_stream_set_rel_id(struct roar_stream * s, int id);
	int roar_stream_get_rel_id(struct roar_stream * s);		int roar_stream_get_rel_id(struct roar_stream * s);

	~~int roar_stream_new_by_id(struct roar_stream * s, int id);~~		Diese Funktionen dienen dazu die so genannte ''relative stream position ID'' zu setzen oder zu lesen.
	~~int roar_stream_new_empty(struct roar_stream * s);~~

	int roar_stream_set_id (struct roar_stream * s, int id);		int roar_stream_set_id (struct roar_stream * s, int id);
	int roar_stream_get_id (struct roar_stream * s);		int roar_stream_get_id (struct roar_stream * s);

			Diese Funktionen sind dazu da die Stream ID des Objektes fest zu legen oder aus zu lesen.

	int roar_stream_set_dir (struct roar_stream * s, int dir);		int roar_stream_set_dir (struct roar_stream * s, int dir);
	int roar_stream_get_dir (struct roar_stream * s);		int roar_stream_get_dir (struct roar_stream * s);

			Mittels dieser Funktionen kann die ''stream direction'' (''dir'') für das Stream Objekt manipuliert oder ausgelesen werden.

			'''Hinweis:''' Diese Funktionen manipulieren lediglich das lokale Objekt und kommunizieren nicht mit dem Server.

	== Daten über Stream mit Server austauschen ==		== Daten über Stream mit Server austauschen ==

Ph3-der-loewe: /* Arbeiten mit Stream Objekten */ nein, diese funktionen lieber nicht erwahenen...

2010-02-08T11:25:21Z

Arbeiten mit Stream Objekten: nein, diese funktionen lieber nicht erwahenen...

← Nächstältere Version		Version vom 8. Februar 2010, 11:25 Uhr
Zeile 12:		Zeile 12:
	int roar_stream_set_id (struct roar_stream * s, int id);		int roar_stream_set_id (struct roar_stream * s, int id);
	int roar_stream_get_id (struct roar_stream * s);		int roar_stream_get_id (struct roar_stream * s);

	~~int roar_stream_set_fh (struct roar_stream * s, int fh);~~
	~~int roar_stream_get_fh (struct roar_stream * s);~~

	int roar_stream_set_dir (struct roar_stream * s, int dir);		int roar_stream_set_dir (struct roar_stream * s, int dir);

Ph3-der-loewe: /* Arbeiten mit Stream Objekten */ makeup typo

2010-02-08T11:23:08Z

Arbeiten mit Stream Objekten: makeup typo

← Nächstältere Version		Version vom 8. Februar 2010, 11:23 Uhr
Zeile 1:		Zeile 1:
	Hier soll kurz anhand der dazu nötigen Funktionen beschrieben werden wie ein Klient Streams generell Manage gen kann.		Hier soll kurz anhand der dazu nötigen Funktionen beschrieben werden wie ein Klient Streams generell Manage gen kann.

	== Arbeiten mit Stream Objekten ===		== Arbeiten mit Stream Objekten ==
	int roar_stream_new (struct roar_stream * s, unsigned int rate, unsigned int channels, unsigned int bits, unsigned int codec);		int roar_stream_new (struct roar_stream * s, unsigned int rate, unsigned int channels, unsigned int bits, unsigned int codec);

Ph3-der-loewe: BEGIN{}

2010-02-08T11:21:49Z

BEGIN{}

Neue Seite

Hier soll kurz anhand der dazu nötigen Funktionen beschrieben werden wie ein Klient Streams generell Manage gen kann.

== Arbeiten mit Stream Objekten ===
int roar_stream_new (struct roar_stream * s, unsigned int rate, unsigned int channels, unsigned int bits, unsigned int codec);

int roar_stream_set_rel_id(struct roar_stream * s, int id);
int roar_stream_get_rel_id(struct roar_stream * s);

int roar_stream_new_by_id(struct roar_stream * s, int id);
int roar_stream_new_empty(struct roar_stream * s);

int roar_stream_set_id (struct roar_stream * s, int id);
int roar_stream_get_id (struct roar_stream * s);

int roar_stream_set_fh (struct roar_stream * s, int fh);
int roar_stream_get_fh (struct roar_stream * s);

int roar_stream_set_dir (struct roar_stream * s, int dir);
int roar_stream_get_dir (struct roar_stream * s);

== Daten über Stream mit Server austauschen ==
int roar_stream_get_info (struct roar_connection * con, struct roar_stream * s, struct roar_stream_info * info);
int roar_stream_get_name (struct roar_connection * con, struct roar_stream * s, char * name, size_t len);

int roar_stream_set_flags (struct roar_connection * con, struct roar_stream * s, int flags, int reset);

roar_list_streams(c,i,m) /* macro */
int roar_get_stream (struct roar_connection * con, struct roar_stream * stream, int id);

== Mixer ==
int roar_set_vol (struct roar_connection * con, int id, struct roar_mixer_settings * mixer, int channels);
int roar_get_vol (struct roar_connection * con, int id, struct roar_mixer_settings * mixer, int * channels);

== Streams erzeugen, verbinden und manipulieren ==
int roar_stream_attach_simple (struct roar_connection * con, struct roar_stream * s, int client);

int roar_kick (struct roar_connection * con, int type, int id);

== Siehe Auch ==
* [[RoarAudio]]

[[Kategorie:RoarAudio]]
[[Kategorie:Software]]
[[Kategorie:Sound]]
[[Kategorie:Programmierung]]
{{Stub}}