SystemSound Classe

Riferimento

Definizione

Spazio dei nomi:: AudioToolbox

Assembly:: Xamarin.iOS.dll

Assembly:: Xamarin.Mac.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Fornisce metodi per produrre suoni semplici.

public class SystemSound : IDisposable, ObjCRuntime.INativeObject

type SystemSound = class
    interface INativeObject
    interface IDisposable

Ereditarietà: Object
SystemSound

Implementazioni: INativeObject IDisposable

Commenti

Questa API deve essere usata per riprodurre effetti sonori o per rendere il dispositivo vibrare. Si usa PlaySystemSoundAsync() per riprodurre suoni brevi e PlayAlertSoundAsync() per riprodurre il suono o vibrare (a seconda delle impostazioni del dispositivo).

A differenza del AVAudioPlayer che funziona con la sessione audio ed è in grado di dimare l'audio, riprodurre in background e interagire con il sistema in base a un set di regole, SystemSound non supporta questo. Quindi è consigliabile evitare in generale di usarlo per qualsiasi cosa, ma effetti sonori e vibrazioni del dispositivo.

A partire da iOS 8, SystemSound presenta le restrizioni seguenti:

Formato audio: PCM o IMA4 (IMA/ADPCM).
Contenitore audio: contenitori .caf, .aif o wav.
Al massimo 30 secondi di durata.
Non esiste alcun controllo volume, che usa il volume di sistema.
Il suono viene riprodotto immediatamente.
Un solo suono può essere riprodotto alla volta, non c'è modo di riprodurre più suoni alla volta.

Per riprodurre un suono, creare prima di tutto un'istanza dell'oggetto SystemSound, tramite il costruttore o uno dei FromFile(String) metodi . Dopo aver creato questo oggetto, chiama uno dei metodi PlaySystemSoundAsync() di riproduzione per riprodurre suoni brevi e PlayAlertSoundAsync().

Costruttori

SystemSound(NSUrl)	Creare un suono di sistema da un file locale.
SystemSound(UInt32)	Fornisce metodi per produrre suoni semplici.

Campi

Vibrate

Un suono di sistema speciale che può essere utilizzato per rendere il dispositivo vibrare.

Proprietà

CompletePlaybackIfAppDies	Controlla se il suono verrà completato durante la riproduzione, anche se l'applicazione muore.
Handle	Handle (puntatore) alla rappresentazione dell'oggetto non gestito.
IsUISound	Ottiene o imposta un valore che indica se eseguire l'override delle preferenze utente durante la chiamata PlaySystemSound()a .

Metodi

AddSystemSoundCompletion(Action, CFRunLoop)	Metodo da richiamare al termine della riproduzione del suono.
Close()	Chiude questo suono di sistema.
Dispose()	Rilascia le risorse utilizzate dall'oggetto SystemSound.
Dispose(Boolean)	Rilascia le risorse utilizzate dall'oggetto SystemSound.
Finalize()	Finalizzatore per l'oggetto SystemSound
FromFile(NSUrl)	Crea un suono di sistema da un file.
FromFile(String)	Matrice di descrizioni di pacchetti che descrivono il contenuto del buffer.
PlayAlertSound()	Riproduce un suono o un avviso.
PlayAlertSound(Action)	Riproduce un suono o un avviso e quindi chiama il gestore.
PlayAlertSoundAsync()	Riproduce in modo asincrono un suono o un avviso, restituendo un T:System.Threading.Task completato al termine del suono.
PlaySystemSound()	Riproduce il suono del sistema.
PlaySystemSound(Action)	Riproduce il suono del sistema e chiama in seguito.
PlaySystemSoundAsync()	Riproduce in modo asincrono un suono di sistema e restituisce un T:System.Threading.Tasks.Task completato al termine del suono.
RemoveSystemSoundCompletion()	Rimuove il metodo di completamento registrato in precedenza.

Si applica a

Condividi tramite