SystemSound Klasse

Referenz

Definition

Namespace:: AudioToolbox

Assembly:: Xamarin.iOS.dll

Assembly:: Xamarin.Mac.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt Methoden zum Erzeugen einfacher Sounds bereit.

public class SystemSound : IDisposable, ObjCRuntime.INativeObject

type SystemSound = class
    interface INativeObject
    interface IDisposable

Vererbung: Object
SystemSound

Implementiert: INativeObject IDisposable

Hinweise

Diese API soll verwendet werden, um Soundeffekte wiederzugeben oder das Gerät zum Vibrieren zu bringen. Sie verwenden PlaySystemSoundAsync() , um kurze Sounds wiederzugeben und PlayAlertSoundAsync() entweder den Sound oder vibrieren (abhängig von den Geräteeinstellungen).

Im Gegensatz zu der AVAudioPlayer , die mit der Audiositzung funktioniert und in der Lage ist, Ihre Audiodaten zu dimmen, im Hintergrund abzuspielen und basierend auf einer Reihe von Regeln mit dem System zu interagieren, unterstützt SystemSound dies nicht. Daher sollten Sie es im Allgemeinen vermeiden, es für alles andere als Soundeffekte und Gerätevibrationen zu verwenden.

Ab iOS 8 gelten für SystemSound die folgenden Einschränkungen:

Audioformat: PCM oder IMA4 (IMA/ADPCM).
Audiocontainer: CAF-, AIF- oder WAV-Container.
Maximal 30 Sekunden.
Es gibt keine Lautstärkeregelung, dies verwendet die Systemlautstärke.
Der Sound wird sofort wiedergegeben.
Es kann nur ein Sound gleichzeitig wiedergegeben werden, es gibt keine Möglichkeit, mehr als einen Sound gleichzeitig wiederzugeben.

Um einen Sound wiederzugeben, erstellen Sie zunächst eine Instanz des SystemSound-Objekts, entweder über den Konstruktor oder eine der FromFile(String) Methoden. Nachdem dieses Objekt erstellt wurde, rufen Sie eine der Wiedergabemethoden PlaySystemSoundAsync() auf, um kurze Sounds wiederzugeben, und PlayAlertSoundAsync().

Konstruktoren

SystemSound(NSUrl)	Erstellen Sie einen Systemsound aus einer lokalen Datei.
SystemSound(UInt32)	Stellt Methoden zum Erzeugen einfacher Sounds bereit.

Felder

Vibrate

Ein spezieller Systemsound, der verwendet werden kann, um das Gerät vibrieren zu lassen.

Eigenschaften

CompletePlaybackIfAppDies	Steuert, ob die Wiedergabe des Sounds abgeschlossen wird, auch wenn die Anwendung stirbt.
Handle	Handle (Zeiger) auf die Darstellung des nicht verwalteten Objekts.
IsUISound	Ruft ab oder legt fest, ob Benutzereinstellungen beim Aufrufen PlaySystemSound()von überschrieben werden sollen.

Methoden

AddSystemSoundCompletion(Action, CFRunLoop)	Methode, die aufgerufen werden soll, wenn die Wiedergabe dieses Sounds abgeschlossen ist.
Close()	Schließt diesen Systemsound.
Dispose()	Gibt die vom SystemSound-Objekt verwendeten Ressourcen frei.
Dispose(Boolean)	Gibt die vom SystemSound-Objekt verwendeten Ressourcen frei.
Finalize()	Finalizer für das SystemSound-Objekt
FromFile(NSUrl)	Erstellt einen Systemsound aus einer Datei.
FromFile(String)	Ein Array von Paketbeschreibungen, die den Inhalt des Puffers beschreiben.
PlayAlertSound()	Gibt einen Sound oder eine Warnung wieder.
PlayAlertSound(Action)	Gibt einen Sound oder eine Warnung wieder und ruft dann den Handler auf.
PlayAlertSoundAsync()	Gibt asynchron einen Sound oder eine Warnung wieder und gibt einen T:System.Threading.Task zurück, der nach dem Ende des Sounds abgeschlossen wird.
PlaySystemSound()	Gibt den Systemsound wieder.
PlaySystemSound(Action)	Gibt den Systemsound wieder und ruft danach auf.
PlaySystemSoundAsync()	Gibt asynchron einen Systemsound wieder und gibt einen T:System.Threading.Tasks.Task zurück, der abgeschlossen wird, wenn der Sound endet.
RemoveSystemSoundCompletion()	Entfernt die zuvor registrierte Vervollständigungsmethode.

Gilt für:

Freigeben über