Alle Quellen für Einbettungen haben eine deterministische URL. In diesem Artikel finden Sie die verschiedenen Pfade und Dateinamen, um die gesuchten Rohressourcen zu finden.
https://space-[space_hash].video-dns.com/[embed_id]/[filename]
Um den Einbettungs-Hash sowohl in space hash als auch in embed id aufzuteilen, nehmen Sie die ersten 5 Ziffern für space hash und die nächsten 10 Ziffern für embed id.
https://space-ubg50.video-dns.com/Cq5Ilpnar1/h264_sd.mp4
Jede Einbettung veröffentlicht außerdem eine manifest.json-Datei im Stammverzeichnis der Einbettung:
https://space-[space_hash].video-dns.com/[embed_id]/manifest.json
Dies ist der maschinenlesbare Einstiegspunkt, der von der Mave-Komponentenbibliothek verwendet wird. Das <mave-player>-Element kann nur eine embed-ID annehmen, dieses Manifest abrufen und es verwenden, um zu entscheiden, welche Video-, Audio-, Untertitel-, Poster- und Storyboard-Dateien geladen werden sollen. Da das Manifest die vom Player benötigten Metadaten enthält, kann die Komponentenbibliothek direkt in einer eigenständigen Webseite verwendet werden, ohne zuerst die Mave-Anwendung aufzurufen.
Das Manifest enthält Metadaten wie:
| Feld | Beschreibung |
|---|---|
| id | Die Einbettungs-ID. |
| name | Der Einbettungsname. |
| space_id | Die Space-ID, die zum Erstellen von CDN-URLs verwendet wird. |
| poster | Poster-, Miniaturbild- und benutzerdefinierte Miniaturbildinformationen. |
| settings | Player-Einstellungen wie Seitenverhältnis, Schleife, Steuerung, Farbe und Posterpräferenz. |
| video | Videometadaten einschließlich Dauer, Sprache, Status, Version, Originaldatei und generierte Wiedergaben. |
| subtitles | Untertitelspuren mit Beschriftungen, Sprachen und Pfaden. |
| audio_tracks | Optionale zusätzliche Audiospuren. |
Das Manifest selbst bleibt an der Wurzel der Einbettung. Erzeugte Mediendateien können versioniert werden: Sobald der Player video.version gelesen hat, lädt er Medien von einem versionierten Pfad wie https://space-ubg50.video-dns.com/Cq5Ilpnar1/v8/thumbnail.jpg. Dadurch können Clients das Manifest aktualisieren und gleichzeitig die generierten Dateien weiterhin sicher zwischenspeichern.
Hierbei handelt es sich um Wiedergaben in voller Länge, die im Element <mave-player> verwendet werden sollen.
| Auflösung | Codec | Behälter | Dateiname |
|---|---|---|---|
| SD 480p | H.264 | MP4 | h264_sd.mp4 |
| HD 720p | H.264 | MP4 | h264_hd.mp4 |
| FHD 1080p | H.264 | MP4 | h264_fhd.mp4 |
| QHD 1440p | H.264 | MP4 | h264_qhd.mp4 |
| UHD 4k | H.264 | MP4 | h264_uhd.mp4 |
| SD 480p | H.264 | HLS | /h264_sd_hls/playlist.m3u8 |
| HD 720p | H.264 | HLS | /h264_hd_hls/playlist.m3u8 |
| FHD 1080p | H.264 | HLS | /h264_fhd_hls/playlist.m3u8 |
| QHD 1440p | H.264 | HLS | /h264_qhd_hls/playlist.m3u8 |
| UHD 4k | H.264 | HLS | /h264_uhd_hls/playlist.m3u8 |
Hierbei handelt es sich um Darstellungen, die auf 60 Sekunden begrenzt sind und im Element <mave-clip> verwendet werden dürfen.
| Auflösung | Codec | Behälter | Dateiname |
|---|---|---|---|
| SD 480p | HEVC | MP4 | hevc_sd_clip.mp4 |
| HD 720p | HEVC | MP4 | hevc_hd_clip.mp4 |
| FHD 1080p | HEVC | MP4 | hevc_fhd_clip.mp4 |
| QHD 1440p | HEVC | MP4 | hevc_qhd_clip.mp4 |
| SD 480p | AV1 | MP4 | av1_sd_clip.mp4 |
| HD 720p | AV1 | MP4 | av1_hd_clip.mp4 |
| FHD 1080p | AV1 | MP4 | av1_fhd_clip.mp4 |
| QHD 1440p | AV1 | MP4 | av1_qhd_clip.mp4 |
Um Videodateien für ein reibungsloses Scrubbing zu optimieren, müssen zusätzliche Keyframes hinzugefügt werden, die Referenzpunkte in einem Video sind. Bei Standardvideos werden Keyframes in regelmäßigen Abständen platziert, was beim Scrollen durch das Video zu Abhackungen führt, da der Player Frames aus entfernten Keyframes berechnet.
| Auflösung | Codec | Behälter | Dateiname |
|---|---|---|---|
| SD 480p | H.264 | MP4 | h264_sd_clip_keyframes.mp4 |
| HD 720p | H.264 | MP4 | h264_hd_clip_keyframes.mp4 |
| FHD 1080p | H.264 | MP4 | h264_fhd_clip_keyframes.mp4 |
| Auflösung | Codec | Beschreibung | Dateiname |
|---|---|---|---|
| Original | JPEG | Erstes Bild des Videos | poster.jpg |
| Original | WebP | Erstes Bild des Videos | poster.webp |
| SD 360p | JPEG | Erster Frame des Videos oder benutzerdefinierter Upload durch den Benutzer | thumbnail.jpg |
| SD 360p | JPEG | Bild aufgenommen auf 0/6 des Videos im Kleinformat | thumbnail_0.jpg |
| SD 360p | JPEG | Bild aufgenommen auf 1/6 des Videos im Kleinformat | thumbnail_1.jpg |
| SD 360p | JPEG | Bild aufgenommen auf 2/6 des Videos im Kleinformat | thumbnail_2.jpg |
| SD 360p | JPEG | Bild aufgenommen auf 3/6 des Videos im Kleinformat | thumbnail_3.jpg |
| SD 360p | JPEG | Bild aufgenommen im 4/6-Format eines Videos im Kleinformat | thumbnail_4.jpg |
| SD 360p | JPEG | Bild aufgenommen auf 5/6 des Videos im Kleinformat | thumbnail_5.jpg |
| Original | AVIF | Poster-Overlay mit Play-Symbol | placeholder.avif |
| Original | WebP | Poster-Overlay mit Play-Symbol | placeholder.webp |
| Original | JPEG | Poster-Overlay mit Play-Symbol | placeholder.jpg |
| Sprite | JPEG | Storyboard-Sprite-Sheet für Miniaturansichten | storyboard.jpg |
Das passende WebVTT-Manifest für die Storyboard-Navigation wird als storyboard.vtt veröffentlicht.
| Bitrate | Codec | Behälter | Dateiname |
|---|---|---|---|
| 128 kbps | LAHM | MP3 | audio.mp4 |
| 128 kbps | AAC | HLS | audio_hls/playlist.m3u8 |
Wenn das Quellvideo mit mehreren Audiospuren geliefert wird, werden diese im gleichen Muster wie _audio_1_hls/playlist.m3u8, _audio_2_hls/playlist.m3u8 usw. veröffentlicht. Manuell über das Dashboard hinzugefügte Audiospuren erhalten generierte IDs (z. B. _audio_track_a1b2_hls/playlist.m3u8_) und sind über die API zugänglich.
