SystemSound Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Proporciona métodos para producir sonidos simples.
public class SystemSound : IDisposable, ObjCRuntime.INativeObject
type SystemSound = class
interface INativeObject
interface IDisposable
- Herencia
-
SystemSound
- Implementaciones
Comentarios
Esta API está pensada para usarse para reproducir efectos de sonido o para hacer vibrar el dispositivo. PlaySystemSoundAsync() Usas para reproducir sonidos cortos y PlayAlertSoundAsync() para reproducir el sonido o vibrar (dependiendo de la configuración del dispositivo).
A diferencia de lo AVAudioPlayer que funciona con la sesión de audio y es capaz de atenuar el audio, reproducir en segundo plano e interactuar con el sistema en función de un conjunto de reglas, SystemSound no admite esto. Por lo tanto, debe evitar usarlo en general para cualquier cosa, pero efectos de sonido y vibración del dispositivo.
A partir de iOS 8, SystemSound tiene las siguientes restricciones:
- Formato de audio: PCM o IMA4 (IMA/ADPCM).
- Contenedor de audio: contenedores .caf, .aif o .wav.
- Como máximo, 30 segundos de duración.
- No hay ningún control de volumen; esto usa el volumen del sistema.
- El sonido se reproduce inmediatamente.
- Solo se puede reproducir un sonido a la vez, no hay forma de reproducir más de un sonido a la vez.
Para reproducir un sonido, primero debe crear una instancia del objeto SystemSound, ya sea a través del constructor o de uno de los FromFile(String) métodos. Una vez creado este objeto, se llama a uno de los métodos de reproducción para reproducir sonidos PlaySystemSoundAsync() cortos y PlayAlertSoundAsync().
Constructores
SystemSound(NSUrl) |
Cree un sonido del sistema a partir de un archivo local. |
SystemSound(UInt32) |
Proporciona métodos para producir sonidos simples. |
Campos
Vibrate |
Sonido especial del sistema que se puede usar para hacer vibrar el dispositivo. |
Propiedades
CompletePlaybackIfAppDies |
Controla si el sonido se completará reproduciendo, incluso si la aplicación muere. |
Handle |
Identificador (puntero) a la representación del objeto no administrado. |
IsUISound |
Obtiene o establece si se invalidan las preferencias de usuario al llamar a PlaySystemSound(). |
Métodos
AddSystemSoundCompletion(Action, CFRunLoop) |
Método para invocar cuando este sonido finaliza la reproducción. |
Close() |
Cierra este sonido del sistema. |
Dispose() |
Libera los recursos utilizados por el objeto SystemSound. |
Dispose(Boolean) |
Libera los recursos utilizados por el objeto SystemSound. |
Finalize() |
Finalizador para el objeto SystemSound |
FromFile(NSUrl) |
Crea un sonido del sistema a partir de un archivo. |
FromFile(String) |
Matriz de descripciones de paquetes que describen el contenido del búfer. |
PlayAlertSound() |
Reproduce un sonido o una alerta. |
PlayAlertSound(Action) |
Reproduce un sonido o una alerta y, a continuación, llama al controlador. |
PlayAlertSoundAsync() |
Reproduce de forma asincrónica un sonido o una alerta, devolviendo un System.Threading.Task que finaliza después de que finalice el sonido. |
PlaySystemSound() |
Reproduce el sonido del sistema. |
PlaySystemSound(Action) |
Reproduce el sonido del sistema y llama después. |
PlaySystemSoundAsync() |
Reproduce de forma asincrónica un sonido del sistema y devuelve un T:System.Threading.Tasks.Task que se completa cuando finaliza el sonido. |
RemoveSystemSoundCompletion() |
Quita el método de finalización registrado anteriormente. |