SystemSound Classe

Referência

Definição

Namespace:: AudioToolbox

Assembly:: Xamarin.iOS.dll

Assembly:: Xamarin.Mac.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Fornece métodos para produzir sons simples.

public class SystemSound : IDisposable, ObjCRuntime.INativeObject

type SystemSound = class
    interface INativeObject
    interface IDisposable

Herança: Object
SystemSound

Implementações: INativeObject IDisposable

Comentários

Essa API destina-se a ser usada para reproduzir efeitos sonoros ou para fazer o dispositivo vibrar. Você usa PlaySystemSoundAsync() para reproduzir sons curtos e PlayAlertSoundAsync() reproduzir o som ou vibrar (dependendo das configurações do dispositivo).

Ao contrário do AVAudioPlayer que funciona com a sessão de áudio e é capaz de esmaecer o áudio, reproduzir em segundo plano e interagir com o sistema com base em um conjunto de regras, o SystemSound não dá suporte a isso. Portanto, você deve, em geral, evitar usá-lo para qualquer coisa, exceto efeitos sonoros e vibração do dispositivo.

A partir do iOS 8, SystemSound tem as seguintes restrições:

Formato de áudio: PCM ou IMA4 (IMA/ADPCM).
Contêiner de áudio: contêineres .caf, .aif ou .wav.
No máximo 30 segundos de duração.
Não há controle de volume, isso usa o volume do sistema.
O som é reproduzido imediatamente.
Apenas um som pode ser tocado de cada vez, não há como tocar mais de um som de cada vez.

Para reproduzir um som, primeiro você cria uma instância do objeto SystemSound, por meio do construtor ou de um dos FromFile(String) métodos. Depois que esse objeto tiver sido criado, você chamará um dos métodos PlaySystemSoundAsync() de reprodução para reproduzir sons curtos e PlayAlertSoundAsync().

Construtores

SystemSound(NSUrl)	Crie um som do sistema a partir de um arquivo local.
SystemSound(UInt32)	Fornece métodos para produzir sons simples.

Campos

Vibrate

Um som especial do sistema que pode ser usado para fazer o dispositivo vibrar.

Propriedades

CompletePlaybackIfAppDies	Controla se o som será concluído, mesmo que o aplicativo seja executado.
Handle	Manipule (ponteiro) para a representação de objeto não gerenciado.
IsUISound	Obtém ou define se as preferências do usuário devem ser substituídas ao chamar PlaySystemSound().

Métodos

AddSystemSoundCompletion(Action, CFRunLoop)	Método a ser invocado quando esse som for concluído.
Close()	Fecha esse som do sistema.
Dispose()	Libera os recursos usados pelo objeto SystemSound.
Dispose(Boolean)	Libera os recursos usados pelo objeto SystemSound.
Finalize()	Finalizador para o objeto SystemSound
FromFile(NSUrl)	Cria um som do sistema com base em um arquivo.
FromFile(String)	Uma matriz de descrições de pacote que descrevem o conteúdo do buffer.
PlayAlertSound()	Reproduz um som ou alerta.
PlayAlertSound(Action)	Reproduz um som ou alerta e, em seguida, chama o manipulador.
PlayAlertSoundAsync()	Reproduza de forma assíncrona um som ou alerta, retornando um T:System.Threading.Task que é concluído após o término do som.
PlaySystemSound()	Reproduz o som do sistema.
PlaySystemSound(Action)	Reproduz o som do sistema e chama depois.
PlaySystemSoundAsync()	Reproduz de forma assíncrona um som do sistema e retorna um T:System.Threading.Tasks.Task que é concluído quando o som termina.
RemoveSystemSoundCompletion()	Remove o método de conclusão registrado anteriormente.

Aplica-se a

Compartilhar via