video — u_pbt_video #

← Référence des composants · Sommaire du guide

Lecteur vidéo : un fichier du poste — servi en flux par la DLL, un long film démarre tout de suite — ou une URL, avec la barre de transport du composant, qui suit le thème : lecture, recherche, temps, muet, volume. Sous-titres WebVTT, affiche avant lecture, boucle, vitesse, cadrage, capture de l'image courante en PNG ou JPEG. Tout ce que l'utilisateur fait sur la barre, votre application le sait.

▶ Le voir en vrai — Application de démonstration, tuile Video player : le film, le code qui le pilote et cette page, côte à côte (connexion Internet requise pour le film d'exemple).

En bref #

Démarrage rapide #

// 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(/*source*/ "films\training.mp4")

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

Tout ce qui se règle est une propriété (is_source, ii_volume, ib_loop…), lue en direct sur le composant ; ce qui se fait est une méthode (of_play, of_pause, of_stop, of_seek, of_capture) ; ce qui arrive est un événement (ue_started, ue_ended, ue_progress…). Un fichier absent n'est pas une exception : ue_failed le dit, et le message s'affiche sur l'image.

Propriétés #

Un clic sur l'image met en pause, un second reprend. Clavier, quand le film a le focus : Espace ou K lecture/pause, ←/→ cinq secondes, ↑/↓ volume, M muet, Début/Fin.

Méthodes #

Événements #

Plein écran, marqueurs, segment, image par image #

• Plein écran. of_fullscreen(true), un double-clic sur l'image ou le dernier bouton de la barre. La DLL déplace le contrôle dans une fenêtre à elle qui couvre le moniteur ; votre fenêtre PowerBuilder n'est pas touchée, et Échap (ou Alt+F4) ramène le film. Il n'est au-dessus de tout que tant qu'il est la fenêtre active : Alt+Tab vers une autre application la fait passer devant, et revenir à votre application ramène le film au-dessus de tout. Échap sort même quand ib_enabled est faux. ue_fullscreen_changed dit chaque passage, dans les deux sens : ces gestes de l'utilisateur comme of_fullscreen.
• Marqueurs. of_add_marker(ms, libellé) pose un repère sur la barre : l'utilisateur le voit, le survole (le libellé), le clique (le film y saute, ue_seeked), et ue_marker_reached arrive quand le film le passe. Chapitres d'une formation, points à contrôler, défauts relevés.
• Segment. of_play_range(de, à) ne joue qu'un extrait ; avec ib_loop il le rejoue jusqu'à of_clear_range.
• Image par image. of_step_frames(±n) avance ou recule de n images à ii_fps par seconde et met en pause ; les touches . et , font de même. Le moteur ne dit pas la cadence d'un film : dites-la.
• La barre parle. Chaque geste a son événement : ue_seeked, ue_volume_changed, ue_rate_changed (le bouton de vitesse, 0,5× à 2×), ue_subtitles_changed (le bouton CC), ue_muted_changed (le haut-parleur, la touche M). Un déplacement demandé par votre code lève le même que le geste : of_seek, of_step_frames et les fonctions de chapitre lèvent ue_seeked. Une VALEUR posée par votre code reste muette, comme 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)

Liste de lecture, sous-titres, reprise, formats #

• Liste de lecture. of_add_source empile des films ; le premier devient is_source, les suivants s'enchaînent d'eux-mêmes à la fin de chacun, ue_source_changed nomme chaque passage. of_next et of_previous à la main, avec le même événement : of_playlist_index dit où en est la liste.
• Ce qui appartient à un film. Son segment, ses sous-titres, ses marqueurs et ses chapitres : un nouvel is_source les laisse derrière lui (posés avant tout film, ils attendent le premier). La liste de lecture garde les siens : le sous-titre donné à of_add_source(film, sous-titre) revient avec son film.
• Plusieurs pistes de sous-titres. of_add_subtitles(langue, fichier) par langue, of_remove_subtitles(langue) pour en retirer une ; is_subtitle_lang choisit, le bouton CC de la barre fait défiler. Un .srt est converti en WebVTT au moment de le servir : rien à convertir chez vous. Un sous-titre donné par URL https est téléchargé par le composant : son serveur doit autoriser CORS, sinon ue_subtitles_failed le dit et le film continue sans lui.
• Reprise. ib_remember_position = true : là où un film est laissé (pause, arrêt) est retenu par le moteur sur ce poste, par utilisateur, et le prochain of_play de la même source y reprend. Un film vu jusqu'au bout repart du début.
• Formats. Ce que WebView2 décode : mp4 (H.264, AAC), webm (VP8, VP9, AV1), mov (le H.264 d'un iPhone ou d'une caméra), mkv (un enregistrement OBS), et les formats audio (mp3, wav, ogg, opus, flac, aac, m4a). Pas le H.265/HEVC sans l'extension Windows (un .mov HEVC finit en ue_failed, qui nomme l'extension), ni l'AVI, le WMV, le FLV : le composant les refuse par leur nom (REASON_FORMAT) au lieu d'un écran noir. Ni HLS ni DASH : une caméra IP passe par un flux mp4 ou webm. Seulement https : une adresse http:// d'intranet est refusée (REASON_INSECURE) — téléchargez le film d'abord (restclient, of_download) ou servez-le par un partage \\serveur\….
• Pistes audio multiples. Chromium les cache derrière un drapeau : non exposées.

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

Exemples #

Une boucle de présentation, silencieuse, sans barre #

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

Vos propres boutons et une barre de progression #

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

Une vignette du film pour un rapport #

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

Bonnes pratiques #

• Un fichier du poste plutôt qu'une URL dès que vous le pouvez : servi en flux par la DLL, il démarre tout de suite, cherche sans recharger, et of_capture peut lire ses pixels — ce qu'un film d'un autre site refuse.
• Scriptez ue_failed sur tout film dont le chemin dépend des données : c'est votre seul filet, et le message est déjà à l'écran.
• Ne posez ib_autoplay que pour une boucle de présentation : un film qui démarre seul avec le son surprend l'utilisateur ; ailleurs, l'affiche et le bouton de lecture suffisent.
• ue_progress remplace un timer : une fois par seconde, position et longueur, uniquement pendant la lecture.

Hérité du socle commun #

Ces membres existent sur tous les composants visuels — ils ne sont pas propres à celui-ci. Ils sont détaillés une seule fois, dans les chapitres transverses ; cette table dit seulement où les lire.

← Référence des composants · Sommaire du guide