Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

fix(engine): emit hvc1 for streaming H.265 GPU outputs

Aperta
  • Qualcosa non va?
#5,003 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

@Monster-GM ci sta già lavorando.

Dal 4/10/2026.

  • #5029 di @Monster-GM — aperta

Valutazione

Difficoltà
3/5
Tempo stimato
1-2 giorni
Idoneità per principianti
78/100
Tipo di issue
Bug
Chiarezza
Specificata chiaramente
Stato di attività
Attiva
Stack tecnologico
typescript
Ambito
audio-video-rtc, testing-qa

Direzione di ricerca

Locate buildStreamingArgs() on current main and inspect the existing argument-construction tests. Verify how software, VideoToolbox, and supported GPU H.265 branches build their commands, then add coverage for H.265 and H.264 cases. Done means every H.265 path has exactly one hvc1 tag while H.264 and VP9 remain unchanged.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

Summary

The streaming encoder adds the MP4 hvc1 sample-entry tag for software H.265, but GPU H.265 branches can omit it. Those outputs may use FFmpeg's default hev1 tag even though the encoded HEVC stream itself is valid.

This reduces compatibility with Apple playback software and other consumers that expect parameter sets through an hvc1 sample entry.

Root cause

In buildStreamingArgs(), the existing:

args.push("-tag:v", "hvc1");

is nested inside the software-encoder branch. The common codec === "h265" decision is outside that branch, so VideoToolbox and the other supported GPU H.265 encoders do not necessarily receive the same container tag.

Affected version

Observed in HyperFrames v0.8.114 (01c6f6004a00ecfa6e77ab4025b47a46a5e925fc). Please confirm against current main.

Expected behavior

Every MP4 streaming H.265 path should append -tag:v hvc1 exactly once, independently of whether the selected encoder is libx265, VideoToolbox, NVENC, VAAPI, QSV, or AMF. H.264 and VP9 paths must remain unchanged.

Proposed change

Move the H.265 sample-entry decision after software/GPU encoder selection but keep it inside the common H.265 branch:

if (codec === "h265") {
  args.push("-tag:v", "hvc1");
}
Validation

Add argument-construction tests covering:

  • software H.265;
  • HDR VideoToolbox H.265;
  • each supported GPU H.265 encoder;
  • software and GPU H.264 negative cases;
  • exactly one hvc1 tag per H.265 command.

The change is container metadata only and does not alter encoded picture data, bitrate, transfer characteristics, or HDR metadata.

Lingua principale
TypeScript
Stelle
54.1k
Fork
4.9k
Merge medio
7h 2m
PR unite (30g)
782

Preparare l'ambiente

Questo progetto non fornisce container di sviluppo, Dockerfile né guida per i contributori, quindi l'ambiente è a tuo carico: parti dal suo README e consulta la nostra guida al primo contributo per i passaggi generali.

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di heygen-com/hyperframes

Tutte le issue di heygen-com/hyperframes

Issue simili

Altre issue su TypeScript

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.