PLAY

4D v20.1

PLAY


PLAY ( nomeObjeto {; canal} )

Parâmetro	Tipo	Descrição
nomeObjeto	String	Nome d arquivo de som ou recurso de Mac OS "snd" ou string vazia de som de sistema para parar a ação assincrônica
canal	Inteiro longo	Se 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