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 (le film d'exemple est livré avec la démonstration ; seul l'exemple 3 vient d'Internet).

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

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

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. Les touches . et , avancent et reculent d'une image, Échap quitte le plein écran ou ferme le menu de vitesse. Dans le menu de vitesse : ↑/↓, Début/Fin, Entrée choisit, Échap et Tab le ferment. Sur un lecteur sans film, Espace et le bouton Lecture ne font rien.

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. Toute recherche reste dans l'extrait : Début mène à son début, un clic au-delà de sa fin à sa fin. En plein écran, la barre se montre aussi au clavier (Tab).
• 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. Avec ib_skip_failed, la liste qui avance seule passe un film qui ne peut pas jouer (son ue_failed est levé une fois) ; la langue de sous-titres choisie suit d'un film à l'autre quand le suivant la porte.
• 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. Posez-les donc APRÈS le film, ou donnez les sous-titres avec lui : of_play(film, sous-titre).
• 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. Aussi toutes les 5 secondes pendant la lecture ; les 200 derniers films sont gardés.
• 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"

Un film de formation à regarder en entier #

Une formation obligatoire, une consigne de sécurité : ib_forward_seek = false empêche l'utilisateur de sauter en avant au-delà de ce qu'il a déjà vu — la barre, les flèches, Fin, un marqueur — sans l'empêcher de revenir en arrière. of_watched_ms et of_watched_percent disent ce qui a été réellement joué (une recherche ne regarde rien), ue_watched_completely arrive une fois quand tout l'a été. En mode démo le film s'arrête à 10 secondes, et le pourcentage dit ce qui a été vu.

// 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 du contrôle Windows Media Player #

Beaucoup d'applications PowerBuilder embarquent l'OCX de Windows Media Player dans un OLECustomControl — un contrôle que Microsoft classe « hérité », et qui fait planter plus d'une application. u_pbt_video le remplace membre à membre. Deux différences à retenir : les positions sont en millisecondes (WMP compte en secondes) et la vitesse en pourcent (ii_rate = 150 pour settings.rate = 1.5).

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