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. 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("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

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 ramène le film. ue_fullscreen_changed le dit dans les deux sens.
• 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. Ce que seul l'utilisateur peut faire est rapporté par un événement à lui : ue_seeked, ue_volume_changed, ue_rate_changed (le bouton de vitesse, 0,5× à 2×), ue_subtitles_changed (le bouton CC). Ce que votre code fait, il le sait déjà : of_seek ne lève rien.

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

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.
• Plusieurs pistes de sous-titres. of_add_subtitles(langue, fichier) par langue ; is_subtitle_lang choisit, le bouton CC de la barre fait défiler. Un .srt est converti en WebVTT par la DLL au moment de le servir : rien à convertir chez vous.
• 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), ogv (Theora), et les formats audio (mp3, wav, ogg, flac, aac, m4a). Pas le H.265/HEVC sans l'extension Windows, ni l'AVI, le WMV, le MKV, le MOV anciens : le composant les refuse par leur nom (ue_failed nomme l'extension) au lieu d'un écran noir. Ni HLS ni DASH : une caméra IP passe par un flux mp4 ou webm.
• Pistes audio multiples. Chromium les cache derrière un drapeau : non exposées.

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

Exemples #

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

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

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 #

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

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