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 ou JPEG. 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(/*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

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 (ou Alt+F4) devolve o filme. Só fica acima de tudo enquanto é a janela ativa: Alt+Tab para outra aplicação volta a pô-lo entre as outras. Escape sai mesmo quando ib_enabled é falso. ue_fullscreen_changed diz cada passagem, nos dois sentidos: estes gestos do utilizador como of_fullscreen.
• 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. Cada gesto tem o seu evento: ue_seeked, ue_volume_changed, ue_rate_changed (o botão de velocidade, 0,5× a 2×), ue_subtitles_changed (o botão CC), ue_muted_changed (o altifalante, a tecla M). Uma deslocação pedida pelo seu código lança o mesmo que o gesto: of_seek, of_step_frames e as funções de capítulo lançam ue_seeked. Um VALOR definido pelo seu código fica mudo, como 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)

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, com o mesmo evento: of_playlist_index diz onde está a lista.
• O que pertence a um filme. O seu segmento, legendas, marcadores e capítulos: um novo is_source deixa-os para trás (definidos antes de qualquer filme, esperam pelo primeiro). A lista de reprodução guarda os seus: a legenda dada a of_add_source(filme, legenda) volta com o seu filme.
• Várias faixas de legendas. of_add_subtitles(idioma, ficheiro) por idioma, of_remove_subtitles(idioma) para retirar uma; is_subtitle_lang escolhe, o botão CC da barra percorre-as. Um .srt é convertido em WebVTT ao ser servido: nada a converter do seu lado. Uma legenda dada por um URL https é descarregada pelo componente: o seu servidor tem de autorizar CORS, senão ue_subtitles_failed di-lo e o filme continua sem ela.
• 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), mov (o H.264 de um iPhone ou de uma câmara), mkv (uma gravação OBS), e os formatos áudio (mp3, wav, ogg, opus, flac, aac, m4a). Não o H.265/HEVC sem a extensão do Windows (um .mov HEVC acaba em ue_failed, que nomeia a extensão), nem AVI, WMV, FLV: o componente recusa-os pelo nome (REASON_FORMAT) em vez de um ecrã negro. Nem HLS nem DASH: uma câmara IP passa por um fluxo mp4 ou webm. Só https: um endereço http:// de intranet é recusado (REASON_INSECURE) — descarregue primeiro o filme (restclient, of_download) ou sirva-o a partir de uma partilha \\servidor\….
• Várias faixas áudio. O Chromium esconde-as atrás de uma flag: não expostas.

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

Exemplos #

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

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

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 #

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

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