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

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 holt den Film zurück. ue_fullscreen_changed sagt es in beide Richtungen.
• 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. Was nur der Benutzer tun kann, meldet ein eigenes Ereignis: ue_seeked, ue_volume_changed, ue_rate_changed (die Geschwindigkeitsschaltfläche, 0,5× bis 2×), ue_subtitles_changed (die CC-Schaltfläche). Was Ihr Code tut, weiß er bereits: of_seek löst nichts aus.

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

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.
• Mehrere Untertitelspuren. of_add_subtitles(Sprache, Datei) pro Sprache; is_subtitle_lang wählt, die CC-Schaltfläche der Leiste schaltet durch. Eine .srt wird von der DLL beim Ausliefern nach WebVTT konvertiert: nichts auf Ihrer Seite zu konvertieren.
• 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), ogv (Theora) und die Audioformate (mp3, wav, ogg, flac, aac, m4a). Kein H.265/HEVC ohne die Windows-Erweiterung, kein altes AVI, WMV, MKV, MOV: die Komponente lehnt sie namentlich ab (ue_failed nennt die Endung) statt einen schwarzen Bildschirm zu zeigen. Kein HLS, kein DASH: eine IP-Kamera geht über einen mp4- oder webm-Stream.
• Mehrere Tonspuren. Chromium verbirgt sie hinter einem Flag: nicht verfügbar.

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

Beispiele #

Eine stumme Präsentationsschleife ohne Leiste #

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

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 #

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

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