Saltar para o conteúdo principal
Versão: 20 R7 BETA

PLAY

PLAY ( nomeObjeto {; canal} )

ParâmetroTipoDescrição
nomeObjetoTextNome d arquivo de som ou recurso de Mac OS "snd" ou string vazia de som de sistema para parar a ação assincrônica
canalIntegerSe especificado, canal de sintetizadr e execução assincrônica; se omitido, execução sincrônica

Descrição

O comando PLAY permite reproduzir arquivos de som ou multimídia. Passe a rota de acesso completa do arquivo que deseja reproduzir em nomeObjeto. Em Mac OS, o comando também pode ser utilizado para reproduzir uma fonte de som ou um som sistema.

  • Para reproduzir um arquivo, passe seu nome e rota de acesso em nomObjeto. Pode passar uma rota de acesso completa ou relativa ao arquivo de estrutura do banco.
    Os principais formatos de arquivos de som e multimídia são compatíveis: .WAV, .MP3, .AVI, .AIFF (Mac OS), etc. Em Mac OS, o comando é compatível particularmente com os formatos Core Audio.
  • (apenas para OS X) Para reproduzir um som de sistema, passe seu nome diretamente no parâmetro objectName.

Nota: os recursos 'snd', utilizados em Mac OS 9 e superiores, já não são suportados.

O parâmetro canal especifica o canal do sintetizador Macintosh. Se não for especificado o canal, o canal será utilizado para sons digitalizados simples e é sincrônico. Sincrônico significa que todos os processos são parados até que o som termine. Se canal for igual a 0, o canal é utilizado para sons digitalizados simples e é assincrônico. Assincrônico significa que o processo não são parados e que o som é reproduzido no fundo.

Para parar um som assincrônico, utilize a próxima instrução:

 PLAY("";0)

Exemplo 1

O exemplo abaixo mostra como reproduzir um arquivo WAV em Windows:

 $DocRef :=Open document("";"WAV";Read Mode)
 If(OK=1)
    CLOSE DOCUMENT($DocRef)
    PLAY(Document;0) //reproduzir assincronicamente
 End if

Exemplo 2

O código de exemplo abaixo reproduz um som do sistema em OS X:

 PLAY("Submarine.aiff")

Ver também

BEEP

Propriedades

Número do comando290
Thread-seguro