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 o JPEG. 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 (la película de ejemplo viene con la demostración; solo el ejemplo 3 viene de Internet).

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

// The film and ITS subtitles in one call : the subtitles belong to this film
uo_video.of_play(/*source*/ "films\training.mp4", /*subtitles*/ "films\training.vtt")

// A URL plays the same way
uo_video.of_play(/*source*/ "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(/*ms*/ 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. Las teclas . y , avanzan y retroceden una imagen, Esc sale de la pantalla completa o cierra el menú de velocidad. En el menú de velocidad: ↑/↓, Inicio/Fin, Intro elige, Esc y Tab lo cierran. En un reproductor sin película, Espacio y el botón Reproducir no hacen nada.

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 (o Alt+F4) devuelve la película. Solo queda por encima de todo mientras es la ventana activa: Alt+Tab hacia otra aplicación pone esa aplicación delante, y volver a la suya pone de nuevo la película por encima de todo. Escape sale incluso cuando ib_enabled es falso. ue_fullscreen_changed dice cada cambio, en ambos sentidos: estos gestos del usuario como of_fullscreen.
• 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. Toda búsqueda queda en el extracto: Inicio lleva a su comienzo, un clic más allá de su fin a su fin. En pantalla completa la barra se muestra también con el teclado (Tab).
• 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. Cada gesto tiene su evento: ue_seeked, ue_volume_changed, ue_rate_changed (el botón de velocidad, 0,5× a 2×), ue_subtitles_changed (el botón CC), ue_muted_changed (el altavoz, la tecla M). Un desplazamiento pedido por su código lanza el mismo que el gesto: of_seek, of_step_frames y las funciones de capítulo lanzan ue_seeked. Un VALOR fijado por su código queda mudo, como SetItem: ii_volume, ii_rate, is_subtitle_lang, ib_muted.

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

// Surveillance : back one picture at a time
uo_video.ii_fps = 30
uo_video.of_step_frames(/*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, con el mismo evento: of_playlist_index dice dónde está la lista. Con ib_skip_failed, la lista que avanza sola salta una película que no puede reproducirse (su ue_failed se lanza una vez); el idioma de subtítulos elegido pasa de una película a otra cuando la siguiente lo lleva.
• Lo que pertenece a una película. Su segmento, sus subtítulos, marcadores y capítulos: un nuevo is_source los deja atrás (fijados antes de cualquier película, esperan a la primera). La lista de reproducción conserva los suyos: el subtítulo dado a of_add_source(película, subtítulo) vuelve con su película. Fíjelos pues DESPUÉS de la película, o dé los subtítulos con ella: of_play(film, subtitle).
• Varias pistas de subtítulos. of_add_subtitles(idioma, archivo) por idioma, of_remove_subtitles(idioma) para quitar una; is_subtitle_lang elige, el botón CC de la barra las recorre. Un .srt se convierte a WebVTT al servirlo: nada que convertir por su parte. Un subtítulo dado por una URL https lo descarga el componente: su servidor debe permitir CORS, si no ue_subtitles_failed lo dice y la película sigue sin él.
• 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. También cada 5 segundos durante la reproducción; se guardan las 200 últimas películas.
• Formatos. Lo que WebView2 decodifica: mp4 (H.264, AAC), webm (VP8, VP9, AV1), mov (el H.264 de un iPhone o de una cámara), mkv (una grabación OBS), y los formatos de audio (mp3, wav, ogg, opus, flac, aac, m4a). No el H.265/HEVC sin la extensión de Windows (un .mov HEVC termina en ue_failed, que nombra la extensión), ni AVI, WMV, FLV: el componente los rechaza por su nombre (REASON_FORMAT) en lugar de una pantalla negra. Ni HLS ni DASH: una cámara IP pasa por un flujo mp4 o webm. Solo https: una dirección http:// de intranet se rechaza (REASON_INSECURE) — descargue antes la película (restclient, of_download) o sírvala desde un recurso compartido \\servidor\….
• Varias pistas de audio. Chromium las esconde tras un flag: no expuestas.

// A playlist, each film WITH its subtitles, the position remembered
uo_video.ib_remember_position = true
uo_video.of_add_source(/*source*/ "intro.mp4", /*subtitles*/ "intro.en.vtt")
uo_video.of_add_source(/*source*/ "lesson-1.mp4", /*subtitles*/ "lesson-1.en.srt")   // .srt : converted by the DLL
uo_video.of_play()

// A second language for the film on screen : it stays with that film
uo_video.of_add_subtitles(/*lang*/ "fr", /*source*/ "intro.fr.vtt")
uo_video.is_subtitle_lang = "fr"

Una película de formación que hay que ver entera #

Una formación obligatoria, una consigna de seguridad: ib_forward_seek = false impide al usuario saltar hacia delante más allá de lo que ya ha visto — la barra, las flechas, Fin, un marcador — sin impedirle volver atrás. of_watched_ms y of_watched_percent dicen lo que se ha reproducido de verdad (una búsqueda no ve nada), ue_watched_completely llega una vez cuando se ha reproducido todo. En modo demo la película se detiene a los 10 segundos, y el porcentaje dice lo que se vio.

// Local variables
long ll_percent

// A training film the user must watch whole : no skipping ahead
uo_video.ib_forward_seek = false
uo_video.of_play(/*source*/ "films\safety-training.mp4", /*subtitles*/ "films\safety-training.srt")

// When the window closes : how much was really seen (ue_watched_completely says 100)
ll_percent = uo_video.of_watched_percent()

Venir del control Windows Media Player #

Muchas aplicaciones PowerBuilder incrustan el OCX de Windows Media Player en un OLECustomControl — un control que Microsoft clasifica como « heredado », y que hace caer más de una aplicación. u_pbt_video lo sustituye miembro a miembro. Dos diferencias que recordar: las posiciones están en milisegundos (WMP cuenta en segundos) y la velocidad en porcentaje (ii_rate = 150 para settings.rate = 1.5).

Ejemplos #

Un bucle de presentación silencioso, sin barra #

// A silent showcase film, in a loop, without its bar
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(/*source*/ "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 #

// Stop the film on the picture to keep
uo_video.of_play(/*source*/ "films\training.mp4")
uo_video.of_pause()
uo_video.of_seek(/*ms*/ 15000)                 // the frame at 0:15

// of_capture waits for the picture itself (10 s at most) : no timer to write.
// A .jpg path writes a JPEG ; 320 : a thumbnail 320 pixels wide.
// A relative path goes to the folder the application started in.
if uo_video.of_capture(/*path*/ "C:\Reports\training.jpg", /*max_width*/ 320) < 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