video — u_pbt_video #

← Riferimento dei componenti · Sommario della guida

Lettore video: un file della postazione — servito in flusso dalla DLL, un film lungo parte subito — o un URL, con la barra di trasporto del componente, che segue il tema: riproduzione, ricerca, tempo, muto, volume. Sottotitoli WebVTT, locandina prima della riproduzione, ciclo, velocità, inquadratura, cattura del fotogramma corrente in PNG. Tutto ciò che l'utente fa sulla barra, la tua applicazione lo sa.

▶ Vederlo dal vivo — Applicazione dimostrativa, riquadro Video player: il film, il codice che lo pilota e questa pagina, fianco a fianco (connessione Internet necessaria per il film di esempio).

In breve #

Avvio rapido #

// 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

Tutto ciò che regoli è una proprietà (is_source, ii_volume, ib_loop…), letta dal vivo sul componente; tutto ciò che fai è un metodo (of_play, of_pause, of_stop, of_seek, of_capture); tutto ciò che accade è un evento (ue_started, ue_ended, ue_progress…). Un file mancante non è un'eccezione: ue_failed lo dice, e il messaggio appare sull'immagine.

Proprietà #

Un clic sull'immagine mette in pausa, un secondo riprende. Tastiera, quando il film ha il focus: Spazio o K riproduci/pausa, ←/→ cinque secondi, ↑/↓ volume, M muto, Inizio/Fine.

Metodi #

Eventi #

Schermo intero, marcatori, segmento, fotogramma per fotogramma #

• Schermo intero. of_fullscreen(true), un doppio clic sull'immagine o l'ultimo pulsante della barra. La DLL sposta il controllo in una finestra sua che copre il monitor; la tua finestra PowerBuilder non è toccata, ed Esc riporta il film. ue_fullscreen_changed lo dice in entrambi i sensi.
• Marcatori. of_add_marker(ms, etichetta) mette un segno sulla barra: l'utente lo vede, lo sorvola (l'etichetta), lo clicca (il film vi salta, ue_seeked), e ue_marker_reached arriva quando il film lo supera. Capitoli di una formazione, punti da controllare, difetti rilevati.
• Segmento. of_play_range(da, a) suona solo un estratto; con ib_loop lo ripete fino a of_clear_range.
• Fotogramma per fotogramma. of_step_frames(±n) avanza o arretra di n immagini a ii_fps al secondo e mette in pausa; i tasti . e , fanno lo stesso. Il motore non dice la cadenza di un film: dilla tu.
• La barra parla. Ciò che solo l'utente può fare è riportato da un evento suo: ue_seeked, ue_volume_changed, ue_rate_changed (il pulsante di velocità, 0,5× a 2×), ue_subtitles_changed (il pulsante CC). Ciò che fa il tuo codice, lo sa già: of_seek non solleva nulla.

// 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)

Playlist, sottotitoli, ripresa, formati #

• Playlist. of_add_source accumula film; il primo diventa is_source, i successivi si susseguono da soli alla fine di ciascuno, ue_source_changed nomina ogni passaggio. of_next e of_previous a mano.
• Più tracce di sottotitoli. of_add_subtitles(lingua, file) per lingua; is_subtitle_lang sceglie, il pulsante CC della barra scorre. Un .srt è convertito in WebVTT dalla DLL al momento di servirlo: nulla da convertire da parte tua.
• Ripresa. ib_remember_position = true: dove un film è lasciato (pausa, stop) è conservato dal motore su questa postazione, per utente, e il prossimo of_play della stessa sorgente riprende lì. Un film visto fino in fondo riparte dall'inizio.
• Formati. Ciò che WebView2 decodifica: mp4 (H.264, AAC), webm (VP8, VP9, AV1), ogv (Theora), e i formati audio (mp3, wav, ogg, flac, aac, m4a). Niente H.265/HEVC senza l'estensione Windows, né AVI, WMV, MKV, MOV vecchi: il componente li rifiuta per nome (ue_failed nomina l'estensione) invece di uno schermo nero. Né HLS né DASH: una telecamera IP passa per un flusso mp4 o webm.
• Più tracce audio. Chromium le nasconde dietro un flag: non esposte.

// 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()

Esempi #

Un ciclo di presentazione silenzioso, senza 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")

I tuoi pulsanti e una barra di avanzamento #

// 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 del film per un rapporto #

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())

Buone pratiche #

• Un file della postazione piuttosto che un URL appena puoi: servito in flusso dalla DLL, parte subito, cerca senza ricaricare, e of_capture può leggerne i pixel — ciò che un film di un altro sito rifiuta.
• Scripta ue_failed su ogni film il cui percorso dipende dai dati: è la tua unica rete, e il messaggio è già sullo schermo.
• Imposta ib_autoplay solo per un ciclo di presentazione: un film che parte da solo con l'audio sorprende l'utente; altrove bastano la locandina e il pulsante di riproduzione.
• ue_progress sostituisce un timer: una volta al secondo, posizione e lunghezza, solo durante la riproduzione.

Ereditato dalla base comune #

Questi membri esistono su tutti i componenti visivi — non sono propri di questo. Sono descritti una sola volta, nei capitoli trasversali; questa tabella dice solo dove leggerli.

← Riferimento dei componenti · Sommario della guida