4D Doc Center : PLAY

4D v13.4

PLAY


PLAY ( nomObjeto {; canal} )

Parámetro	Tipo	Descripción
nomObjeto	Cadena	Nombre de archivo de sonido o sonido sistema Cadena vacía para detener un sonido asincrónico
canal	Entero largo	Si se pasa, canal de salida y ejecución asincrónico Si se omite, ejecución sincrónica

Descripción

El comando PLAY permite reproducir archivos de sonido o multimedia. Pase la ruta de acceso completa del archivo que quiere reproducir en nombreObjeto. En Mac OS, el comando también puede utilizarse para reproducir un sonido sistema.

Para reproducir un archivo, pase su nombre y ruta de acceso en nomObjeto. Puede pasar una ruta de acceso completa o relativa al archivo de estructura de la base.
Se soportan los principales formatos de archivos sonido y multimedia: .WAV, .MP3, .AVI, .AIFF (Mac OS), etc. Bajo Mac OS, el comando soporta particularmente formatos Core Audio.
Nota: no puede reproducir archivos u objetos multimedia en modo asincrónico. Para hacerlo, utilice los servicios OLE.
(Mac OS únicamente) para reproducir un sonido sistema, pase directamente su nombre en el parámetro nomObjeto.
Nota: por razones de compatibilidad, 4D primero busca por un recurso "snd" llamado nomObjeto.

El parámetro canal especifica el canal de salida del sintetizador Macintosh. Si no se especifica el canal, el canal se utiliza para sonidos digitalizados simples y es sincrónico. Sincrónico significa que todos los procesos se detienen hasta que el sonido termina. Si canal es igual a 0, el canal se utiliza para sonidos digitalizados simples y es asincrónico. Asincrónico significa que el proceso no se detiene y que el sonido se reproduce de fondo.

Para detener un sonido asincrónico, utilice la siguiente instrucción:

PLAY("";0)

Ejemplo 1

El siguiente ejemplo muestra cómo reproducir un archivo video en Windows:

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

 If(OK=1)

    CLOSE DOCUMENT($DocRef)

    PLAY(Documento)

 End if

Ejemplo 2

El siguiente ejemplo de código aparece en un método de inicio. Da la bienvenida al usuario con un sonido llamado Sonido Bienvenida en Macintosh:

PLAY("Sonido Bienvenida") ` Reproducir Sonido Bienvenida