video — u_pbt_video #

← Referencia de componentes · Índice de la guía

Reproductor de vídeo: un archivo del equipo — servido en flujo por la DLL, una película larga empieza enseguida — o una URL, con la barra de transporte del componente, que sigue el tema: reproducción, búsqueda, tiempo, silencio, volumen. Subtítulos WebVTT, cartel antes de la reproducción, bucle, velocidad, encuadre, captura del fotograma actual en PNG. Todo lo que el usuario hace en la barra, su aplicación lo sabe.

▶ Verlo en vivo — Aplicación de demostración, mosaico Video player: la película, el código que la controla y esta página, lado a lado (conexión a Internet necesaria para la película de ejemplo).

De un vistazo #

Inicio rápido #

// A film of the workstation, streamed by the DLL : starts at once
uo_video.is_poster = "img\packimages.dll:PNG/COVER"   // shown until the film starts
uo_video.is_subtitles = "films\training.vtt"
uo_video.of_play("films\training.mp4")

// A URL plays the same way
uo_video.of_play("https://www.w3schools.com/html/mov_bbb.mp4")

// The user pauses from the bar, or your code does : either way ue_paused fires
uo_video.of_pause()
uo_video.of_seek(90000)          // to 1:30, in milliseconds

Todo lo que se ajusta es una propiedad (is_source, ii_volume, ib_loop…), leída en directo del componente; todo lo que se hace es un método (of_play, of_pause, of_stop, of_seek, of_capture); todo lo que ocurre es un evento (ue_started, ue_ended, ue_progress…). Un archivo ausente no es una excepción: ue_failed lo dice, y el mensaje se muestra sobre la imagen.

Propiedades #

Un clic en la imagen pausa, un segundo reanuda. Teclado, cuando la película tiene el foco: Espacio o K reproducir/pausa, ←/→ cinco segundos, ↑/↓ volumen, M silencio, Inicio/Fin.

Métodos #

Eventos #

Pantalla completa, marcadores, segmento, imagen por imagen #

• Pantalla completa. of_fullscreen(true), un doble clic en la imagen o el último botón de la barra. La DLL mueve el control a una ventana propia que cubre el monitor; su ventana PowerBuilder no se toca, y Escape devuelve la película. ue_fullscreen_changed lo dice en ambos sentidos.
• Marcadores. of_add_marker(ms, etiqueta) pone una marca en la barra: el usuario la ve, la sobrevuela (la etiqueta), la clica (la película salta ahí, ue_seeked), y ue_marker_reached llega cuando la película la pasa. Capítulos de una formación, puntos a controlar, defectos detectados.
• Segmento. of_play_range(desde, hasta) reproduce solo un extracto; con ib_loop lo repite hasta of_clear_range.
• Imagen por imagen. of_step_frames(±n) avanza o retrocede n imágenes a ii_fps por segundo y pausa; las teclas . y , hacen lo mismo. El motor no dice la cadencia de una película: dígala usted.
• La barra habla. Lo que solo el usuario puede hacer lo reporta un evento propio: ue_seeked, ue_volume_changed, ue_rate_changed (el botón de velocidad, 0,5× a 2×), ue_subtitles_changed (el botón CC). Lo que hace su código, ya lo sabe: of_seek no lanza nada.

// Chapters on the bar, then one extract in a loop
uo_video.of_add_marker(2000, "Intro")
uo_video.of_add_marker(5000, "The bunny")
uo_video.ib_loop = true
uo_video.of_play_range(2000, 8000)

// Surveillance : back one picture at a time
uo_video.ii_fps = 30
uo_video.of_step_frames(-1)

Lista de reproducción, subtítulos, reanudación, formatos #

• Lista de reproducción. of_add_source apila películas; la primera pasa a ser is_source, las siguientes se encadenan solas al final de cada una, ue_source_changed nombra cada paso. of_next y of_previous a mano.
• Varias pistas de subtítulos. of_add_subtitles(idioma, archivo) por idioma; is_subtitle_lang elige, el botón CC de la barra recorre. Un .srt es convertido a WebVTT por la DLL al servirlo: nada que convertir por su parte.
• Reanudación. ib_remember_position = true: donde se deja una película (pausa, parada) lo guarda el motor en este equipo, por usuario, y el siguiente of_play de la misma fuente reanuda ahí. Una película vista hasta el final vuelve a empezar.
• Formatos. Lo que WebView2 decodifica: mp4 (H.264, AAC), webm (VP8, VP9, AV1), ogv (Theora), y los formatos de audio (mp3, wav, ogg, flac, aac, m4a). Sin H.265/HEVC sin la extensión de Windows, ni AVI, WMV, MKV, MOV antiguos: el componente los rechaza por su nombre (ue_failed nombra la extensión) en vez de una pantalla negra. Ni HLS ni DASH: una cámara IP pasa por un flujo mp4 o webm.
• Varias pistas de audio. Chromium las esconde tras un flag: no expuestas.

// A playlist with two subtitle tracks, the position remembered
uo_video.ib_remember_position = true
uo_video.of_add_subtitles("en", "film.en.vtt")
uo_video.of_add_subtitles("fr", "film.fr.srt")     // .srt : converted by the DLL
uo_video.is_subtitle_lang = "fr"
uo_video.of_add_source("intro.mp4")
uo_video.of_add_source("lesson-1.mp4")
uo_video.of_play()

Ejemplos #

Un bucle de presentación silencioso, sin barra #

uo_video.ib_controls = false
uo_video.ib_muted = true
uo_video.ib_loop = true
uo_video.is_stretch = u_pbt_video.STRETCH_UNIFORMTOFILL
uo_video.of_play("films\showcase.mp4")

Sus propios botones y una barra de progreso #

// cb_play.clicked
if uo_video.of_is_paused() or not uo_video.of_is_playing() then uo_video.of_play() else uo_video.of_pause()

// uo_video.ue_progress : once a second, no timer needed
hpb_progress.Position = al_position_ms * 100 / Max(al_duration_ms, 1)

Una miniatura de la película para un informe #

uo_video.of_play("films\training.mp4")
uo_video.of_pause()
uo_video.of_seek(15000)                 // the frame at 0:15
// of_capture waits for the picture itself (10 s at most) : no timer to write
if uo_video.of_capture("report\training.png") <> 0 then MessageBox("Capture", uo_video.of_get_last_error())

Buenas prácticas #

• Un archivo del equipo antes que una URL siempre que pueda: servido en flujo por la DLL, arranca enseguida, busca sin recargar, y of_capture puede leer sus píxeles — lo que una película de otro sitio rechaza.
• Programe ue_failed en toda película cuya ruta dependa de los datos: es su única red, y el mensaje ya está en pantalla.
• Fije ib_autoplay solo para un bucle de presentación: una película que arranca sola con sonido sorprende al usuario; en otros casos bastan el cartel y el botón de reproducción.
• ue_progress sustituye a un timer: una vez por segundo, posición y longitud, solo durante la reproducción.

Heredado de la base común #

Estos miembros existen en todos los componentes visuales — no son propios de este. Se detallan una sola vez, en los capítulos transversales; esta tabla solo dice dónde leerlos.

← Referencia de componentes · Índice de la guía