14.11 ossaudiodev -- Accesso ai dispositivi audio OSS-compatibili

14.11 ossaudiodev -- Accesso ai dispositivi audio OSS-compatibili

Disponibilità: Linux, FreeBSD.

Nuovo nella versione 2.3.

Questo modulo permette di accedere all'interfaccia OSS (Open Sound System). OSS è disponibile per una vasta gamma di prodotti open source e commerciali derivati da Unix e l'interfaccia audio standard per Linux e le versioni recenti di FreeBSD.

Vedete anche:

Open Sound System Programmer's Guide: la documentazione ufficiale per le API C OSS

Il modulo definisce un largo numero di costanti supportate del driver dispositivo di periferica OSS, vedere <sys/soundcard.h> su ogni Linux o FreeBSD per un elenco.

ossaudiodev definisce le seguenti variabili e funzioni:

exception OSSAudioError

Questa eccezione viene sollevata per errori certi. L'argomento è una stringa che descrive ciò che è andato storto.

Se ossaudiodev riceve un errore da una chiamata di sistema come open(), write(), o ioctl(), solleva un'eccezione IOError. Gli errori rilevati direttamente da ossaudiodev risultano in OSSAudioError.

Per retrocompatibilitè , la classe dell'eccezione è anche disponibile come ossaudiodev.error.

open( [device, ]mode)

Apre una periferica audio e restituisce un oggetto dispositivo OSS audio. Questo oggetto supporta molti metodi simile a file, come read(), write() e fileno() (anche se ci sono differenze sottili fra la semantica nella lettura/scrittura convenzionale di Unixe quelle dei dispositivi audio OSS). Supporta anche un numero di metodi specifici per l'audio; vedere sotto per la lista completa dei metodi.

device è il nome della periferica audio da usare. Se il nome del file non viene specificato, questo modulo cerca prima nella variabile di sviluppo AUDIODEV per il dispositivo da usare. Se non la trova, ritorna a /dev/dsp.

mode indica 'r' per l'accesso in sola lettura (record), 'w' per l'accesso in sola scrittura (riproduzione) ed 'rw' per entrambi. Da quando molte schede audio permettono ad un solo processo di avere il registratore o il riproduttore aperti per volta, è una buona idea aprire il dispositivo solo per l'attività richiesta. Ulteriormente alcune schede audio sono mezze duplex: possono essere aperte in lettura e scrittura ma non insieme.

Notare la sintassi della chiamata inusuale: il primo argomento è facoltativo ed il secondo viene richiesto. Questo è uno storico artefatto per conservare la compatibilità con il vecchio modulo linuxaudiodev che ossaudiodev sostituisce.

openmixer( [device])

Apre una periferica mixer e restituisce un dispositivo oggetto OSS. device è il nome del dispositivo mixer da usare. Se non viene specificata, questo modulo cerca prima nella variabile di sviluppo MIXERDEV per la periferica da usare. Se non la trova, ritorna a /dev/mixer.

Vedete Circa questo documento... per informazioni su modifiche e suggerimenti.