SystemSound Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет методы для создания простых звуков.
public class SystemSound : IDisposable, ObjCRuntime.INativeObject
type SystemSound = class
interface INativeObject
interface IDisposable
- Наследование
-
SystemSound
- Реализации
Комментарии
Этот API предназначен для воспроизведения звуковых эффектов или для вибрации устройства. Вы используете для PlaySystemSoundAsync() воспроизведения коротких звуков и PlayAlertSoundAsync() воспроизведения звука или вибрации (в зависимости от настроек устройства).
AVAudioPlayer В отличие от , который работает с аудиосеансом и может затемнить звук, воспроизводить в фоновом режиме и взаимодействовать с системой на основе набора правил, SystemSound не поддерживает это. Поэтому в целом следует избегать использования его для чего угодно, кроме звуковых эффектов и вибрации устройства.
По состоянию на iOS 8 SystemSound имеет следующие ограничения:
- Аудиоформат: PCM или IMA4 (IMA/ADPCM).
- Аудиоконтейнер: контейнеры .caf, .aif или .wav.
- Длительность не более 30 секунд.
- Регулировка громкости отсутствует, для этого используется системный том.
- Звук воспроизводится немедленно.
- Одновременно можно воспроизводить только один звук, нельзя воспроизводить несколько звуков одновременно.
Чтобы воспроизвести звук, сначала создайте экземпляр объекта SystemSound с помощью конструктора FromFile(String) или одного из методов. После создания этого объекта вызывается один из методов 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() |
Удаляет ранее зарегистрированный метод завершения. |