PLAY
PLAY ( nomObjeto {; canal} )
| Parámetro | Tipo | Descripción | |
|---|---|---|---|
| nomObjeto | Text | → | Nombre de archivo de sonido o sonido sistemaCadena vacía para detener un sonido asincrónico |
| canal | Integer | → | Si se pasa, canal de salida y ejecución asincrónico Si se omite, ejecución sincrónica |
Este comando no es hilo seguro, no puede ser utilizado en código apropiativo.
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 OS X, 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 (OS X), etc. Bajo OS X, el comando soporta particularmente formatos Core Audio. - (OS X únicamente) para reproducir un sonido sistema, pase directamente su nombre en el parámetro nomObjeto .
Nota: los recursos 'snd', utilizados en Mac OS 9 y superiores, ya no se soportan.
El parámetro asincrono permite reproducir de forma asíncrona en Windows. Síncrono significa que todo el procesamiento se detiene hasta que el sonido haya terminado de reproducirse, asíncrono significa que la reproducción no se detiene y el sonido se reproduce de fondo. Si se pasa asincrono y contiene 0 (o cualquier valor entero largo), el sonido se reproduce de forma asíncrona. Si se omite, el sonido se reproduce de forma sincrónica.
Para detener un sonido asincrónico, utilice la siguiente instrucción:
PLAY("";0)
Ejemplo 1
El siguiente ejemplo muestra cómo reproducir un archivo WAV en Windows:
$DocRef :=Open document("";"WAV";Read Mode)
If(OK=1)
CLOSE DOCUMENT($DocRef)
PLAY(Document;0) //reproducir asíncronamente
End if
Ejemplo 2
El siguiente código de ejemplo reproduce un sonido del sistema en OS X:
PLAY("Submarine.aiff")