video — u_pbt_video #

← Komponentenreferenz · Inhalt des Handbuchs

Videoplayer: eine Datei des Arbeitsplatzes — von der DLL gestreamt, ein langer Film startet sofort — oder eine URL, mit der eigenen Transportleiste der Komponente, die dem Thema folgt: Wiedergabe, Suche, Zeit, Stumm, Lautstärke. WebVTT-Untertitel, Poster vor der Wiedergabe, Schleife, Geschwindigkeit, Zuschnitt, Aufnahme des aktuellen Bilds als PNG oder JPEG. Was der Benutzer auf der Leiste tut, weiß Ihre Anwendung.

▶ Live ansehen — Demoanwendung, Kachel Video player: der Film, der Code, der ihn steuert, und diese Seite nebeneinander (Internetverbindung für den Beispielfilm nötig).

Auf einen Blick #

Schnellstart #

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

Alles, was Sie einstellen, ist eine Eigenschaft (is_source, ii_volume, ib_loop…), live von der Komponente gelesen; alles, was Sie tun, ist eine Methode (of_play, of_pause, of_stop, of_seek, of_capture); alles, was geschieht, ist ein Ereignis (ue_started, ue_ended, ue_progress…). Eine fehlende Datei ist keine Ausnahme: ue_failed sagt es, und die Meldung erscheint auf dem Bild.

Eigenschaften #

Ein Klick auf das Bild pausiert, ein zweiter setzt fort. Tastatur, wenn der Film den Fokus hat: Leertaste oder K Wiedergabe/Pause, ←/→ fünf Sekunden, ↑/↓ Lautstärke, M stumm, Pos1/Ende.

Methoden #

Ereignisse #

Vollbild, Marken, Abschnitt, Bild für Bild #

• Vollbild. of_fullscreen(true), ein Doppelklick auf das Bild oder die letzte Schaltfläche der Leiste. Die DLL verschiebt das Steuerelement in ein eigenes Fenster, das den Monitor bedeckt; Ihr PowerBuilder-Fenster bleibt unberührt, und Escape (oder Alt+F4) holt den Film zurück. Über allem bleibt es nur, solange es das aktive Fenster ist: Alt+Tab zu einer anderen Anwendung bringt diese nach vorn, und die Rückkehr zu Ihrer Anwendung legt den Film wieder über alles. Escape verlässt es auch, wenn ib_enabled falsch ist. ue_fullscreen_changed meldet jeden Wechsel in beide Richtungen: diese Gesten des Benutzers ebenso wie of_fullscreen.
• Marken. of_add_marker(ms, Beschriftung) setzt einen Strich auf die Leiste: der Benutzer sieht ihn, fährt ihn an (die Beschriftung), klickt ihn (der Film springt dorthin, ue_seeked), und ue_marker_reached kommt, wenn der Film ihn passiert. Kapitel einer Schulung, zu prüfende Stellen, gefundene Mängel.
• Abschnitt. of_play_range(von, bis) spielt nur einen Ausschnitt; mit ib_loop wiederholt es ihn bis of_clear_range.
• Bild für Bild. of_step_frames(±n) bewegt um n Bilder bei ii_fps pro Sekunde und pausiert; die Tasten . und , tun dasselbe. Die Engine nennt die Bildrate eines Films nicht: Sie tun es.
• Die Leiste spricht. Jede Geste hat ihr Ereignis: ue_seeked, ue_volume_changed, ue_rate_changed (die Geschwindigkeitsschaltfläche, 0,5× bis 2×), ue_subtitles_changed (die CC-Schaltfläche), ue_muted_changed (der Lautsprecher, die Taste M). Eine von Ihrem Code verlangte Bewegung löst dasselbe aus wie die Geste: of_seek, of_step_frames und die Kapitelfunktionen lösen ue_seeked aus. Ein von Ihrem Code gesetzter WERT bleibt stumm, wie 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)

Wiedergabeliste, Untertitel, Fortsetzen, Formate #

• Wiedergabeliste. of_add_source stapelt Filme; der erste wird is_source, die nächsten folgen von selbst am Ende jedes Films, ue_source_changed nennt jeden Wechsel. of_next und of_previous von Hand, mit demselben Ereignis: of_playlist_index sagt, wo die Liste steht.
• Was zu einem Film gehört. Sein Abschnitt, seine Untertitel, Marken und Kapitel: ein neues is_source lässt sie zurück (vor jedem Film gesetzt, warten sie auf den ersten). Die Wiedergabeliste behält ihre eigenen: der an of_add_source(Film, Untertitel) gegebene Untertitel kommt mit seinem Film zurück.
• Mehrere Untertitelspuren. of_add_subtitles(Sprache, Datei) pro Sprache, of_remove_subtitles(Sprache) entfernt eine; is_subtitle_lang wählt, die CC-Schaltfläche der Leiste schaltet durch. Eine .srt wird beim Ausliefern in WebVTT konvertiert: bei Ihnen ist nichts zu konvertieren. Ein Untertitel per https-URL wird von der Komponente heruntergeladen: ihr Server muss CORS erlauben, sonst meldet ue_subtitles_failed es und der Film läuft ohne ihn weiter.
• Fortsetzen. ib_remember_position = true: wo ein Film verlassen wird (Pause, Stopp), merkt sich die Engine auf diesem Arbeitsplatz, pro Benutzer, und das nächste of_play derselben Quelle setzt dort fort. Ein zu Ende gesehener Film beginnt von vorn.
• Formate. Was WebView2 dekodiert: mp4 (H.264, AAC), webm (VP8, VP9, AV1), mov (das H.264 eines iPhones oder einer Kamera), mkv (eine OBS-Aufnahme) und die Audioformate (mp3, wav, ogg, opus, flac, aac, m4a). Kein H.265/HEVC ohne die Windows-Erweiterung (ein HEVC-.mov endet in ue_failed, das die Endung nennt), weder AVI, WMV noch FLV: die Komponente lehnt sie an ihrem Namen ab (REASON_FORMAT) statt eines schwarzen Bildschirms. Weder HLS noch DASH: eine IP-Kamera läuft über einen mp4- oder webm-Stream. Nur https: eine http://-Intranetadresse wird abgelehnt (REASON_INSECURE) — laden Sie den Film zuerst herunter (restclient, of_download) oder liefern Sie ihn über eine Freigabe \\server\….
• Mehrere Tonspuren. Chromium verbirgt sie hinter einem Flag: nicht verfügbar.

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

Beispiele #

Eine stumme Präsentationsschleife ohne Leiste #

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

Eigene Knöpfe und eine Fortschrittsleiste #

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

Ein Vorschaubild des Films für einen Bericht #

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

Bewährte Praxis #

• Eine Datei des Arbeitsplatzes statt einer URL, wann immer möglich: von der DLL gestreamt startet sie sofort, sucht ohne Neuladen, und of_capture darf ihre Pixel lesen — was ein Film einer anderen Site verweigert.
• Skripten Sie ue_failed bei jedem Film, dessen Pfad von Daten abhängt: es ist Ihr einziges Netz, und die Meldung steht bereits am Bildschirm.
• Setzen Sie ib_autoplay nur für eine Präsentationsschleife: ein Film, der mit Ton von selbst startet, überrascht den Benutzer; sonst genügen Poster und Wiedergabeknopf.
• ue_progress ersetzt einen Timer: einmal pro Sekunde, Position und Länge, nur während der Wiedergabe.

Vom gemeinsamen Sockel geerbt #

Diese Mitglieder gibt es bei jeder visuellen Komponente — sie sind nicht dieser eigen. Sie werden einmal in den übergreifenden Kapiteln beschrieben; diese Tabelle sagt nur, wo man sie liest.

← Komponentenreferenz · Inhalt des Handbuchs