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 o JPEG. 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 (il film di esempio è fornito con la dimostrazione; solo l'esempio 3 viene da Internet).

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

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

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. I tasti . e , avanzano e arretrano di un fotogramma, Esc esce dallo schermo intero o chiude il menu della velocità. Nel menu della velocità: ↑/↓, Inizio/Fine, Invio sceglie, Esc e Tab lo chiudono. Su un lettore senza film, Spazio e il pulsante Riproduci non fanno nulla.

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 (o Alt+F4) riporta il film. Resta sopra tutto solo finché è la finestra attiva: Alt+Tab verso un'altra applicazione porta quella davanti, e tornare alla tua rimette il film sopra tutto. Esc esce anche quando ib_enabled è falso. ue_fullscreen_changed dice ogni passaggio, in entrambi i sensi: questi gesti dell'utente come of_fullscreen.
• 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. Ogni ricerca resta nell'estratto: Inizio porta al suo inizio, un clic oltre la sua fine alla sua fine. A schermo intero la barra si mostra anche da tastiera (Tab).
• 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. Ogni gesto ha il suo evento: ue_seeked, ue_volume_changed, ue_rate_changed (il pulsante di velocità, 0,5× a 2×), ue_subtitles_changed (il pulsante CC), ue_muted_changed (l'altoparlante, il tasto M). Uno spostamento chiesto dal tuo codice solleva lo stesso evento del gesto: of_seek, of_step_frames e le funzioni dei capitoli sollevano ue_seeked. Un VALORE impostato dal tuo codice resta muto, come 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)

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, con lo stesso evento: of_playlist_index dice dove si trova la lista. Con ib_skip_failed, la playlist che avanza da sola salta un film che non può essere riprodotto (il suo ue_failed è sollevato una volta); la lingua dei sottotitoli scelta segue da un film all'altro quando il successivo la porta.
• Ciò che appartiene a un film. Il suo segmento, i sottotitoli, i marcatori e i capitoli: un nuovo is_source li lascia indietro (impostati prima di ogni film, aspettano il primo). La playlist conserva i suoi: il sottotitolo dato a of_add_source(film, sottotitolo) torna con il suo film. Impostali quindi DOPO il film, o dai i sottotitoli con lui: of_play(film, subtitle).
• Più tracce di sottotitoli. of_add_subtitles(lingua, file) per lingua, of_remove_subtitles(lingua) per toglierne una; is_subtitle_lang sceglie, il pulsante CC della barra scorre. Un .srt è convertito in WebVTT al momento di servirlo: niente da convertire da parte tua. Un sottotitolo dato da un URL https è scaricato dal componente: il suo server deve consentire CORS, altrimenti ue_subtitles_failed lo dice e il film continua senza.
• 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. Anche ogni 5 secondi durante la riproduzione; sono conservati gli ultimi 200 film.
• Formati. Ciò che WebView2 decodifica: mp4 (H.264, AAC), webm (VP8, VP9, AV1), mov (l'H.264 di un iPhone o di una videocamera), mkv (una registrazione OBS), e i formati audio (mp3, wav, ogg, opus, flac, aac, m4a). Non l'H.265/HEVC senza l'estensione Windows (un .mov HEVC finisce in ue_failed, che nomina l'estensione), né AVI, WMV, FLV: il componente li rifiuta dal loro nome (REASON_FORMAT) invece di uno schermo nero. Né HLS né DASH: una telecamera IP passa per un flusso mp4 o webm. Solo https: un indirizzo http:// di intranet è rifiutato (REASON_INSECURE) — scarica prima il film (restclient, of_download) o servilo da una condivisione \\server\….
• Più tracce audio. Chromium le nasconde dietro un flag: non esposte.

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

Un film di formazione da guardare per intero #

Una formazione obbligatoria, un'istruzione di sicurezza: ib_forward_seek = false impedisce all'utente di saltare in avanti oltre ciò che ha già visto — la barra, le frecce, Fine, un marcatore — senza impedirgli di tornare indietro. of_watched_ms e of_watched_percent dicono ciò che è stato davvero riprodotto (una ricerca non guarda nulla), ue_watched_completely arriva una volta quando lo è stato tutto. In modalità demo il film si ferma a 10 secondi, e la percentuale dice ciò che è stato visto.

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

Venire dal controllo Windows Media Player #

Molte applicazioni PowerBuilder incorporano l'OCX di Windows Media Player in un OLECustomControl — un controllo che Microsoft classifica come « legacy », e che fa cadere più di un'applicazione. u_pbt_video lo sostituisce membro per membro. Due differenze da ricordare: le posizioni sono in millisecondi (WMP conta in secondi) e la velocità in percentuale (ii_rate = 150 per settings.rate = 1.5).

Esempi #

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

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 #

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

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