Video Player rozhraní se vzorovým snímkem z traileru Sintel.
Video Player rozhraní se vzorovým snímkem z traileru Sintel.
© copyright Blender Foundation | durian.blender.org · CC BY 3.0
← Všechny nativní průvodce

Xodera Plugins · Bubble Native

Xodera Video Player Native

Zobrazte lekce, produktové demonstrace a podporované živé streamy ve své aplikaci, s ovládacími prvky přehrávání, režimem celé obrazovky a dostupnými jazykovými stopami.

Public beta guides · Haptics instructions are in its Bubble listing

Public beta offer: free Bubble install · 7-day card trial, then US$1.50/month per plugin/project.

Dokumentace přezkoumána 6 listopad 2026

Praktické příklady

Odkazy na kapitoly v tréninkové aplikaci

Uživatel potřebuje přehrát jeden krok demonstrace bez přechodu na externí přehrávač.

`source_url = Current Lesson’s video URL`; `poster_url = Current Lesson’s cover`; každá kapitola ukládá startovní čas vlastněný aplikací.

Clic na kapitolu → pokud se mění zdroj, počkejte na `source_loaded` → Seek do `position_seconds` → Play. Použijte Set playback rate pro podrobnou demonstraci a Enter fullscreen na požádání.

Přečtěte `position_seconds`, `duration_seconds` a `is_fullscreen`; váš pracovní postup ukládá postup lekce pouze pro aktuální zdroj.

Na `player_error` zobrazte `error_code`, zachovejte postup a nabídněte Reload video. Událost dokončení není důkazem, že byla lekce nebo bezpečnostní hodnocení úspěšně absolvována.

Používejte přímé video soubory nebo podporované streamy. Tento přehrávač neexportuje videa.

Video demonstrace v nabídkách na tržišti

Obrázek produktu sám nedokáže vysvětlit, jak položka funguje, ale video mimo stránku narušuje nákupní proces.

`source_url = Selected Listing’s demonstration URL`; `poster_url = its thumbnail`; `muted = yes` pro úmyslně tichý první náhled.

Otevřete vybraný výpis → připojte jeho video → Play po akci uživatele. Nabídněte Set muted pro zvuk a Enter fullscreen pro podrobnější prohlédnutí. Připojte `is_active` k viditelnému detailu.

Použijte `has_source`, `is_buffering` a `status` k rozlišení chybějícího videa, načítání a připraveného média.

Při výměně zdroje přestaňte používat starý postup a výběry stop. Zobrazte náhradní miniaturu, pokud je vybraný soubor nepodporovaný.

Používejte přímé video soubory nebo podporované streamy. Tento přehrávač neexportuje videa.

Vyberte dostupné jazykové stopy v podporovaném proudu.

Vícejazyčná aplikace musí nabízet stopy, které konkrétní zdroj skutečně obsahuje.

`source_url = Selected Programme’s accepted stream URL`; zdroj sám musí poskytovat kompatibilní audio/podtitulkové stopy.

Při `tracks_changed` načtěte aktuální `audio_tracks_json` a `subtitle_tracks_json`; vytvořte volby ve své aplikaci a zavolejte Select audio track nebo Select subtitle track s aktuálním indexem.

Použijte `selected_audio_index`, `selected_subtitle_index` a `source_generation` k přiřazení volby k tomuto zdroji.

Po každé změně zdroje znovu sestavte volby. Pokud stopa chybí nebo není podporována, zachovejte výchozí stopu a upřímně zobrazte její dostupnost.

Používejte přímé video soubory nebo podporované streamy. Tento přehrávač neexportuje videa.

Co funguje nyní

Public beta. Use the documented controls and actions; test supported formats, permissions and device behavior in your own native app. Browser preview does not validate native device output.

Vytvořte pracovní postup

Použijte níže dostupné beta akce a otestujte výsledek na svých cílových zařízeních.

Tyto příklady používají záznamy aplikace, jako jsou Lesson, Message a Order. Nahraďte je vlastními typy dat a názvy prvků. Příkladové adresy médií je třeba nahradit vlastními soubory.

  1. Nastavte source_url = Selected Lesson's video_url a poster_url = Selected Lesson's poster_url. Použijte auto nebo progressive pro MP4; použijte hls pro stream HLS.

  2. Po playback_ready použijte Seek k pokračování na uloženém position_seconds. Uživatel spustí Play. Nastavte is_active podle toho, zda je zobrazení lekce otevřeno.

  3. Přidejte ovládací prvky Play, Pause, Seek, Set playback rate a Enter fullscreen. Zobrazte position_seconds a duration_seconds.

  4. Po tracks_changed zobrazte dostupné volby audio_tracks_json a subtitle_tracks_json pro toto video. Předávejte vybraný index do Select audio track nebo Select subtitle track. Při události ended uložte postup.

Diagram pracovního postupu — ne snímek obrazovky aplikace

Nastavte jednou

Vytvořte nebo vyberte svůj projekt aplikace Bubble v BestPlugins → Dashboard → Plugins. Vyberte Xodera Video Player Native, zkopírujte jeho klíč, poté otevřete Bubble → Plugins → Xodera Video Player Native a vložte jej do licensing_api_key. Uložte jednou; poté použijte akce níže. Každý plugin v každém projektu má svůj vlastní klíč.

Použijte přímou adresu videa nebo streamu. Adresa YouTube nebo webová stránka Vimeo není přímý video soubor. Přehrávání nevyžaduje přístup ke kameře ani mikrofonu.

Nastavte jednou
  1. Vytvořte nebo vyberte svůj projekt aplikace Bubble v BestPlugins → Dashboard → Plugins.
  2. Vyberte tento plugin a zkopírujte jeho projektový klíč.
  3. Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
  4. Přidejte prvek, vyberte svá data aplikace a vytvořte níže uvedený pracovní postup.
  5. In the dashboard, review and confirm the 7-day card trial for this plugin. It then costs US$1.50/month per app project, including development and production. Cancel before the trial ends to avoid the first charge.
Instalace a předplatné

For Audio Player, Video Player, Photo Editor, Audio Recorder, Files Kit and Haptics: free Bubble installation, a 7-day trial with a card, then US$1.50 per month per plugin and app project. Development and production are included, with no operation cap. File-size and feature limits still apply. Review billing and cancellation before confirming. Other plugins remain unavailable for purchase.

Uložte výsledek ve své aplikaci

Příklad WatchProgress: owner = Current User, lesson = Selected Lesson, seconds = Video Player's position_seconds, duration = Video Player's duration_seconds. Ukládejte pouze pro aktuálně vybrané video. Indexy stop patří k tomuto videu a neměly by být uloženy jako trvalé jazykové volby.

Selhání, zrušení a obnovení

Na player_error zobrazte error_code a nabídněte Reload video. Znovu se načte bez spuštění přehrávání. Výběrem jiného zdroje se vymažou staré volby stop. Opuštění pohledu pozastaví video; uživatel stiskne Play pro pokračování.

Možnosti a limity

Rychlosti: 0.5, 1, 1.5 a 2. Hlasitost: 0–1. Formáty: auto, progressive, HLS a Android‑only DASH. Dostupné stopy závisí na souboru. Použijte -1 k vypnutí stopy; -2 znamená neznámé a nelze jej vybrat. Žádná úprava, export videa, DRM, obraz v obraze ani trvalá offline cache.

Nastavení, akce a výsledky

Použijte tyto názvy v Bubble. Plánované funkce jsou označeny zvlášť.

Dostupná beta nastavení

Nastavení prvku

source_url · textposter_url · textcontent_type · textrate · numbervolume · numbermuted · yes/noloop · yes/nois_active · yes/nodisabled · yes/nonative_controls · yes/noui_text_json · textlanguage · text

Stavy

is_playing · yes/nois_buffering · yes/nopending_play · yes/nois_live · yes/nomuted · yes/noloop · yes/nohas_source · yes/nois_fullscreen · yes/noposition_seconds · numberduration_seconds · numbervolume · numberrate · numbersource_generation · numberselected_audio_index · numberselected_subtitle_index · numberstatus · textaudio_tracks_json · textsubtitle_tracks_json · texterror_code · texterror_message · text

Události

source_changedsource_loadedplayback_readyplaying_changedtime_changedendedtracks_changedfullscreen_changedplayer_error

Akce a jejich vstupy

PlayPauseStop and rewindReload videoSeekSet volumeSet mutedSet playback rateEnter fullscreenSelect audio trackSelect subtitle track
Nastavení prvku · 12
source_urltext · Výchozí: ""
Ukázková hodnotahttps://bestplugins.online/native-samples/lesson.mp4
Příklad Bubble výrazuSelected Lesson's video_url
Adresa vybraného audio, video nebo obrázkového souboru. Použijte typ souboru, který tento plugin podporuje.
poster_urltext · Výchozí: ""
Ukázková hodnotahttps://bestplugins.online/native-samples/poster.jpg
Příklad Bubble výrazuSelected Lesson's poster_url
Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.
content_typetext · Výchozí: "auto"
Ukázková hodnotaauto
Příklad Bubble výrazuSelected Lesson's video_content_type
Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.
ratenumber · Výchozí: 1
Ukázková hodnota1.5
Příklad Bubble výrazuSpeed Dropdown's value
Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.
volumenumber · Výchozí: 1
Ukázková hodnota0.8
Příklad Bubble výrazuVolume Slider's value
Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.
mutedyes/no · Výchozí: false
Ukázková hodnotano
Příklad Bubble výrazuMute Checkbox is checked
Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.
loopyes/no · Výchozí: false
Ukázková hodnotano
Příklad Bubble výrazuSelected Lesson's repeat_enabled
Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.
is_activeyes/no · Výchozí: true
Ukázková hodnotayes
Příklad Bubble výrazuGuideHost's view_is_active (your yes/no custom state)
Nastavte ano, dokud je tento pohled otevřený. Nastavte ne při odchodu, aby se přehrávání nebo aktuální práce mohly zastavit.
disabledyes/no · Výchozí: false
Ukázková hodnotano
Příklad Bubble výrazuGuideHost's is_busy (your yes/no custom state)
Deaktivujte prvek, když je aplikace zaneprázdněná nebo je tato akce nedostupná.
native_controlsyes/no · Výchozí: false
Ukázková hodnotano
Příklad Bubble výrazuApp Settings' use_native_video_controls
Zobrazit nebo skrýt standardní video ovládací prvky zařízení.
ui_text_jsontext · Výchozí: "{}"
Ukázková hodnota{}
Příklad Bubble výrazuApp Settings' player_labels_json (supported keys only)
Volitelný JSON s podporovanými popisky tlačítek. Nechte prázdné pro použití vestavěného textu.
languagetext · Výchozí: "auto"
Ukázková hodnotauk
Příklad Bubble výrazuCurrent User's preferred_language
Nastavte language=auto tak, aby sledoval podporované zařízení nebo jazyk prohlížeče. Zadejte podporovaný kód jazyka pro jeho explicitní výběr.
Akce a jejich vstupy · 11
Play

Žádné parametry akce

Pause

Žádné parametry akce

Stop and rewind

Žádné parametry akce

Reload video

Žádné parametry akce

Seek
position_secondsnumber · Výchozí: —
Ukázková hodnota45
Příklad Bubble výrazuSelected Chapter's start_seconds
Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.
Set volume
volumenumber · Výchozí: —
Ukázková hodnota0.8
Příklad Bubble výrazuVolume Slider's value
Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.
Set muted
mutedyes/no · Výchozí: —
Ukázková hodnotano
Příklad Bubble výrazuMute Checkbox is checked
Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.
Set playback rate
ratenumber · Výchozí: —
Ukázková hodnota1.5
Příklad Bubble výrazuSpeed Dropdown's value
Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.
Enter fullscreen

Žádné parametry akce

Select audio track
indexnumber · Výchozí: —
Ukázková hodnota0
Příklad Bubble výrazuSelected row's current_source_index
Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.
Select subtitle track
indexnumber · Výchozí: —
Ukázková hodnota0
Příklad Bubble výrazuSelected row's current_source_index
Použijte hodnotu aktuálního obchodního záznamu; ověřte ji vůči níže uvedeným limitům.
Stavy a události

Stavy

is_playing · yes/no

Aktuální hodnota vybrané položky. Přečtěte ji po související události.

is_buffering · yes/no

Aktuální hodnota vybrané položky. Přečtěte ji po související události.

pending_play · yes/no

Aktuální hodnota vybrané položky. Přečtěte ji po související události.

is_live · yes/no

Aktuální hodnota vybrané položky. Přečtěte ji po související události.

muted · yes/no

Aktuální hodnota vybrané položky. Přečtěte ji po související události.

loop · yes/no

Aktuální hodnota vybrané položky. Přečtěte ji po související události.

has_source · yes/no

Aktuální hodnota vybrané položky. Přečtěte ji po související události.

is_fullscreen · yes/no

Aktuální hodnota vybrané položky. Přečtěte ji po související události.

position_seconds · number

Aktuální hodnota vybrané položky. Přečtěte ji po související události.

duration_seconds · number

Aktuální hodnota vybrané položky. Přečtěte ji po související události.

volume · number

Aktuální hodnota vybrané položky. Přečtěte ji po související události.

rate · number

Aktuální hodnota vybrané položky. Přečtěte ji po související události.

source_generation · number

Aktuální hodnota vybrané položky. Přečtěte ji po související události.

selected_audio_index · number

Aktuální hodnota vybrané položky. Přečtěte ji po související události.

selected_subtitle_index · number

Aktuální hodnota vybrané položky. Přečtěte ji po související události.

status · text

Aktuální výsledek této akce. Použijte odpovídající událost dokončení před uložením úspěchu. idle,loading,readyToPlay,error

audio_tracks_json · text

Aktuální hodnota vybrané položky. Přečtěte ji po související události.

subtitle_tracks_json · text

Aktuální hodnota vybrané položky. Přečtěte ji po související události.

error_code · text

Informace o chybě poslední akce. Zobrazte užitečnou zprávu a nabídněte příslušný opakovaný pokus.

error_message · text

Informace o chybě poslední akce. Zobrazte užitečnou zprávu a nabídněte příslušný opakovaný pokus.

Události

source_changed

Když nastane tato událost, přečtěte související stavy ze stejného prvku.

source_loaded

Když nastane tato událost, přečtěte související stavy ze stejného prvku.

playback_ready

Když nastane tato událost, přečtěte související stavy ze stejného prvku.

playing_changed

Když nastane tato událost, přečtěte související stavy ze stejného prvku.

time_changed

Když nastane tato událost, přečtěte související stavy ze stejného prvku.

ended

Když nastane tato událost, přečtěte související stavy ze stejného prvku.

tracks_changed

Když nastane tato událost, přečtěte související stavy ze stejného prvku.

fullscreen_changed

Když nastane tato událost, přečtěte související stavy ze stejného prvku.

player_error

Když nastane tato událost, přečtěte související stavy ze stejného prvku.

Otázky, které vývojáři kladou

Mohu exportovat vybraný úsek?

Ne. Seek a režim celé obrazovky mění přehrávání, ne video data.

Jak funguje předplatné?

For Audio Player, Video Player, Photo Editor, Audio Recorder, Files Kit and Haptics: free Bubble installation, a 7-day trial with a card, then US$1.50 per month per plugin and app project. Development and production are included, with no operation cap. File-size and feature limits still apply. Review billing and cancellation before confirming. Other plugins remain unavailable for purchase.

Související průvodci

Pro pomoc nám sdělte, který plugin a zařízení používáte, jakou akci jste zkusili a co se stalo. Použijte příklad bez osobních údajů. Nikdy nesdílejte svůj klíč ani soukromé soubory.