SystemSound クラス

リファレンス

定義

名前空間:: AudioToolbox

アセンブリ:: Xamarin.iOS.dll

アセンブリ:: Xamarin.Mac.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

単純なサウンドを生成するためのメソッドを提供します。

public class SystemSound : IDisposable, ObjCRuntime.INativeObject

type SystemSound = class
    interface INativeObject
    interface IDisposable

継承: Object
SystemSound

実装: INativeObject IDisposable

注釈

この API は、サウンドエフェクトを再生したり、デバイスを振動させたりするために使用することを目的としています。短いサウンドを再生したり、PlayAlertSoundAsync()サウンドを再生したり、(デバイスの設定に応じて) 振動したりするために使用PlaySystemSoundAsync()します。

AVAudioPlayerオーディオセッションで動作し、オーディオを暗くし、バックグラウンドで再生し、ルールのセットに基づいてシステムと対話することができるとは異なり、SystemSoundはこれをサポートしていません。そのため、一般的には、効果音やデバイスの振動以外には使用しないようにする必要があります。

iOS 8 以降、SystemSound には次の制限があります。

オーディオ形式: PCM または IMA4 (IMA/ADPCM)。
オーディオコンテナー: .caf、.aif、または .wav コンテナー。
最大 30 秒の期間。
ボリューム制御はありません。これはシステムボリュームを使用します。
サウンドはすぐに再生されます。
一度に再生できるサウンドは 1 つだけで、一度に複数のサウンドを再生する方法はありません。

サウンドを再生するには、まず、コンストラクターまたはいずれかのメソッドを使用して SystemSound オブジェクトのインスタンスを FromFile(String) 作成します。このオブジェクトが作成されたら、再生メソッド PlaySystemSoundAsync() の 1 つを呼び出して、短いサウンドと 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()	以前に登録した完了メソッドを削除します。

適用対象

次の方法で共有