4D Doc Center : PLAY

4D v12.4

PLAY


PLAY ( nomeObjeto {; canal} )

Parâmetro	Tipo	Descrição
nomeObjeto	cadeia	Nome do arquivo de som ou recurso de Mac OS "snd" ou cadeia 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 nomeObjeto. 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.
Nota: não pode reproduzir arquivos ou objetos multimídia em modo assincrônico. Para fazer, utilize os serviços OLE.
(Mac OS apenas) para reproduzir um recurso "snd" ou um som sistema, passe diretamente seu nome no parâmetro nomeObjeto.
Nota: por razões de compatibilidade, 4D primeiro busca por um recurso "snd" chamado nomeObjeto.

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 video em Windows:

 $DocRef :=Open document("";"AVI")

 If(OK=1)

    CLOSE DOCUMENT($DocRef)

    PLAY(Documento)

 End if

Exemplo 2

O exemplo de código abaixo aparece em um método de início. Dá às boas-vindas ao usuário com um som chamado Som de Boas-vindas em Macintosh:

PLAY("Som de Boas-vindas") ` Reproduzir Som de Boas-vindas