video — u_pbt_video #

← Referência dos componentes · Índice do guia

Leitor de vídeo: um ficheiro do posto — servido em fluxo pela DLL, um filme longo começa de imediato — ou um URL, com a barra de transporte do componente, que segue o tema: reprodução, procura, tempo, silêncio, volume. Legendas WebVTT, cartaz antes da reprodução, ciclo, velocidade, enquadramento, captura da imagem atual em PNG. Tudo o que o utilizador faz na barra, a sua aplicação sabe.

▶ Ver ao vivo — Aplicação de demonstração, mosaico Video player: o filme, o código que o controla e esta página, lado a lado (ligação à Internet necessária para o filme de exemplo).

Em resumo #

Início rápido #

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

Tudo o que se define é uma propriedade (is_source, ii_volume, ib_loop…), lida em direto no componente; tudo o que se faz é um método (of_play, of_pause, of_stop, of_seek, of_capture); tudo o que acontece é um evento (ue_started, ue_ended, ue_progress…). Um ficheiro ausente não é uma exceção: ue_failed di-lo, e a mensagem aparece sobre a imagem.

Propriedades #

Um clique na imagem pausa, um segundo retoma. Teclado, quando o filme tem o foco: Espaço ou K reproduzir/pausa, ←/→ cinco segundos, ↑/↓ volume, M silêncio, Início/Fim.

Métodos #

Eventos #

Ecrã inteiro, marcadores, segmento, imagem a imagem #

• Ecrã inteiro. of_fullscreen(true), um duplo clique na imagem ou o último botão da barra. A DLL move o controlo para uma janela própria que cobre o monitor; a sua janela PowerBuilder não é tocada, e Escape devolve o filme. ue_fullscreen_changed di-lo nos dois sentidos.
• Marcadores. of_add_marker(ms, rótulo) põe um traço na barra: o utilizador vê-o, sobrevoa-o (o rótulo), clica-o (o filme salta para lá, ue_seeked), e ue_marker_reached chega quando o filme o passa. Capítulos de uma formação, pontos a controlar, defeitos detetados.
• Segmento. of_play_range(de, a) toca só um excerto; com ib_loop repete-o até of_clear_range.
• Imagem a imagem. of_step_frames(±n) avança ou recua n imagens a ii_fps por segundo e pausa; as teclas . e , fazem o mesmo. O motor não diz a cadência de um filme: diga-a.
• A barra fala. O que só o utilizador pode fazer é reportado por um evento próprio: ue_seeked, ue_volume_changed, ue_rate_changed (o botão de velocidade, 0,5× a 2×), ue_subtitles_changed (o botão CC). O que o seu código faz, ele já sabe: of_seek não levanta nada.

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

Lista de reprodução, legendas, retoma, formatos #

• Lista de reprodução. of_add_source empilha filmes; o primeiro torna-se is_source, os seguintes encadeiam-se sozinhos no fim de cada um, ue_source_changed nomeia cada passagem. of_next e of_previous à mão.
• Várias faixas de legendas. of_add_subtitles(idioma, ficheiro) por idioma; is_subtitle_lang escolhe, o botão CC da barra percorre. Um .srt é convertido em WebVTT pela DLL ao servi-lo: nada a converter do seu lado.
• Retoma. ib_remember_position = true: onde um filme é deixado (pausa, paragem) é guardado pelo motor neste posto, por utilizador, e o próximo of_play da mesma fonte retoma aí. Um filme visto até ao fim recomeça do início.
• Formatos. O que o WebView2 descodifica: mp4 (H.264, AAC), webm (VP8, VP9, AV1), ogv (Theora), e os formatos áudio (mp3, wav, ogg, flac, aac, m4a). Sem H.265/HEVC sem a extensão do Windows, nem AVI, WMV, MKV, MOV antigos: o componente recusa-os pelo nome (ue_failed nomeia a extensão) em vez de um ecrã preto. Nem HLS nem DASH: uma câmara IP passa por um fluxo mp4 ou webm.
• Várias faixas áudio. O Chromium esconde-as atrás de uma flag: não expostas.

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

Exemplos #

Um ciclo de apresentação silencioso, sem barra #

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

Os seus botões e uma barra de progresso #

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

Uma miniatura do filme para um relatório #

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

Boas práticas #

• Um ficheiro do posto em vez de um URL sempre que puder: servido em fluxo pela DLL, arranca de imediato, procura sem recarregar, e of_capture pode ler os seus píxeis — o que um filme de outro site recusa.
• Programe ue_failed em qualquer filme cujo caminho dependa dos dados: é a sua única rede, e a mensagem já está no ecrã.
• Defina ib_autoplay só para um ciclo de apresentação: um filme que arranca sozinho com som surpreende o utilizador; noutros casos bastam o cartaz e o botão de reprodução.
• ue_progress substitui um timer: uma vez por segundo, posição e comprimento, só durante a reprodução.

Herdado da base comum #

Estes membros existem em todos os componentes visuais — não são próprios deste. São detalhados uma só vez, nos capítulos transversais; esta tabela apenas diz onde os ler.

← Referência dos componentes · Índice do guia