SystemSound 类

定义

命名空间:

AudioToolbox

程序集:

Xamarin.iOS.dll

提供用于生成简单声音的方法。

public class SystemSound : IDisposable, ObjCRuntime.INativeObject

type SystemSound = class
    interface INativeObject
    interface IDisposable

继承

Object

SystemSound

实现

INativeObject IDisposable

注解

此 API 用于播放声音效果或使设备振动。 使用 PlaySystemSoundAsync() 播放短声音，并 PlayAlertSoundAsync() 播放声音或振动 (，具体取决于设备设置) 。

AVAudioPlayer与适用于音频会话且能够调暗音频、在后台播放并根据一组规则与系统交互的 不同，SystemSound 不支持此功能。 因此，通常应避免将其用于声音效果和设备振动之外的任何内容。

从 iOS 8 起，SystemSound 具有以下限制：

• 音频格式：PCM 或 IMA4 (IMA/ADPCM) 。
• 音频容器：.caf、.aif 或 .wav 容器。
• 持续时间最多为 30 秒。
• 没有音量控制，这使用系统卷。
• 立即播放声音。
• 一次只能播放一个声音，无法一次播放多个声音。

若要播放声音，请先通过 构造函数或方法之 FromFile(String) 一创建 SystemSound 对象的实例。 创建此对象后，可以调用播放方法 PlaySystemSoundAsync() 之一来播放短声音 和 PlayAlertSoundAsync()。

构造函数

SystemSound(NSUrl)	从本地文件创建系统声音。
SystemSound(UInt32)	提供用于生成简单声音的方法。

字段

Vibrate

可用于使设备振动的特殊系统声音。

属性

CompletePlaybackIfAppDies	控制声音是否将完成播放，即使应用程序死亡。
Handle	处理指向非托管对象表示形式的 (指针) 。
IsUISound	获取或设置调用 PlaySystemSound()时是否替代用户首选项。

方法

AddSystemSoundCompletion(Action, CFRunLoop)	当此声音完成播放时调用的方法。
Close()	关闭此系统声音。
Dispose()	释放 SystemSound 对象使用的资源。
Dispose(Boolean)	释放 SystemSound 对象使用的资源。
Finalize()	SystemSound 对象的终结器
FromFile(NSUrl)	从文件创建系统声音。
FromFile(String)	描述缓冲区内容的数据包说明数组。
PlayAlertSound()	播放声音或警报。
PlayAlertSound(Action)	播放声音或警报，然后调用处理程序。
PlayAlertSoundAsync()	异步播放声音或警报，返回在声音结束后完成的 T：System.Threading.Task 。
PlaySystemSound()	播放系统声音。
PlaySystemSound(Action)	播放系统声音并随后调用。
PlaySystemSoundAsync()	异步播放系统声音，并返回在声音结束时完成的 T：System.Threading.Tasks.Task 。
RemoveSystemSoundCompletion()	删除以前注册的完成方法。