共用方式為

SystemSound 類別

  • 參考

定義

命名空間:
AudioToolbox
組件:
Xamarin.iOS.dll
組件:
Xamarin.Mac.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

處理 unmanaged 物件標記法) (指標。
IsUISound

取得或設定是否要在呼叫 PlaySystemSound() 時覆寫使用者喜好設定。

方法

AddSystemSoundCompletion(Action, CFRunLoop)

這個音效完成播放時叫用的方法。
Close()

關閉此系統音效。
Dispose()

釋放 SystemSound 物件所使用的資源。
Dispose(Boolean)

釋放 SystemSound 物件所使用的資源。
Finalize()

SystemSound 物件的完成項
FromFile(NSUrl)

從檔案建立系統音效。
FromFile(String)

描述緩衝區內容的封包描述陣列。
PlayAlertSound()

播放音效或警示。
PlayAlertSound(Action)

播放音效或警示，然後呼叫 處理常式。
PlayAlertSoundAsync()

以非同步方式播放音效或警示，並傳回在音效結束時完成的。
PlaySystemSound()

播放系統音效。
PlaySystemSound(Action)

播放系統音效，並在之後呼叫 。
PlaySystemSoundAsync()

以非同步方式播放系統音效，並傳回音效結束時完成的 T：System.Threading.Tasks.Task。
RemoveSystemSoundCompletion()

移除先前註冊的完成方法。

適用於