Antara muka Video Player dengan bingkai contoh dari treler Sintel.
Antara muka Video Player dengan bingkai contoh dari treler Sintel.
© copyright Blender Foundation | durian.blender.org · CC BY 3.0
← Semua panduan asli

Xodera Plugins · Bubble Native

Xodera Video Player Native

Tunjukkan pelajaran, demonstrasi produk dan siaran langsung yang disokong dalam aplikasi anda, dengan kawalan main semula, skrin penuh dan trek bahasa yang tersedia.

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.

Dokumentasi disemak 6 November 2026

Contoh praktikal

Pautan bab dalam aplikasi latihan

Seorang pelajar perlu memainkan semula satu langkah demonstrasi tanpa menavigasi ke pemain luar.

`source_url = Current Lesson’s video URL`; `poster_url = Current Lesson’s cover`; setiap Bab menyimpan masa mula yang dimiliki aplikasi.

Klik Bab → jika menukar sumber, tunggu `source_loaded` → Seek kepada `position_seconds` → Play. Gunakan Set playback rate untuk demonstrasi terperinci dan Enter fullscreen apabila diminta.

Baca `position_seconds`, `duration_seconds` dan `is_fullscreen`; aliran kerja anda menyimpan kemajuan pelajaran hanya untuk sumber semasa.

Pada `player_error`, tunjuk `error_code`, kekalkan kemajuan dan tawarkan Reload video. Acara selesai bukan bukti bahawa pelajaran atau penilaian keselamatan telah lulus.

Gunakan fail video langsung atau aliran yang disokong. Pemain ini tidak mengeksport video.

Demonstrasi video pada senarai pasar

Imej produk sahaja tidak dapat menjelaskan cara sesuatu item berfungsi, tetapi video luar tapak mengganggu aliran pembelian.

`source_url = Selected Listing’s demonstration URL`; `poster_url = its thumbnail`; `muted = yes` untuk pratonton pertama yang sengaja senyap.

Buka Penyenaraian terpilih → kaitkan videonya → Play selepas tindakan pengguna. Tawarkan Set muted untuk bunyi dan Enter fullscreen untuk pemeriksaan lebih dekat. Kaitkan `is_active` kepada sama ada paparan butiran sedang kelihatan.

Gunakan `has_source`, `is_buffering` dan `status` untuk membezakan video tiada, memuat dan media sedia.

Apabila sumber diganti, hentikan penggunaan kemajuan lama dan pilihan trek. Tunjukkan gambar kecil gantian apabila fail terpilih tidak disokong.

Gunakan fail video langsung atau aliran yang disokong. Pemain ini tidak mengeksport video.

Pilih trek bahasa yang tersedia dalam aliran yang disokong

Aplikasi berbilang bahasa perlu menawarkan trek yang sebenarnya terdapat dalam sumber tertentu.

`source_url = Selected Programme’s accepted stream URL`; sumber itu sendiri mesti menyediakan trek audio/subtitel yang serasi.

Pada `tracks_changed`, baca `audio_tracks_json` dan `subtitle_tracks_json` semasa; bina pilihan dalam aplikasi anda dan panggil Select audio track atau Select subtitle track dengan indeks semasa.

Gunakan `selected_audio_index`, `selected_subtitle_index` dan `source_generation` untuk mengaitkan pilihan dengan sumber ini.

Bina semula pilihan selepas setiap perubahan sumber. Jika trek tiada atau tidak disokong, kekalkan trek lalai dan tunjukkan ketersediaannya dengan jujur.

Gunakan fail video langsung atau aliran yang disokong. Pemain ini tidak mengeksport video.

Apa yang berfungsi sekarang

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.

Bina aliran kerja

Gunakan tindakan beta yang tersedia di bawah dan uji hasilnya pada peranti sasaran anda.

Contoh-contoh ini menggunakan rekod aplikasi seperti Lesson, Message dan Order. Gantikan mereka dengan jenis data dan nama elemen anda sendiri. Alamat media contoh mesti diganti dengan fail anda sendiri.

  1. Tetapkan source_url = Selected Lesson's video_url dan poster_url = Selected Lesson's poster_url. Gunakan auto atau progressive untuk MP4; gunakan hls untuk aliran HLS.

  2. Selepas playback_ready, gunakan Seek untuk menyambung pada position_seconds yang disimpan. Pengguna memulakan Play. Tetapkan is_active kepada sama ada pandangan pelajaran dibuka.

  3. Tambah kawalan Play, Pause, Seek, Set playback rate dan Enter fullscreen. Paparkan position_seconds dan duration_seconds.

  4. Selepas tracks_changed, tunjuk pilihan audio_tracks_json dan subtitle_tracks_json yang tersedia untuk video ini. Hantar indeks terpilih kepada Select audio track atau Select subtitle track. Apabila peristiwa ended berlaku, simpan kemajuan.

Diagram aliran kerja — bukan tangkapan skrin aplikasi

Konfigurasi sekali

Buat atau pilih projek aplikasi Bubble anda dalam BestPlugins → Dashboard → Plugins. Pilih Xodera Video Player Native, salin kuncinya, kemudian buka Bubble → Plugins → Xodera Video Player Native dan tampal ke dalam licensing_api_key. Simpan sekali; kemudian gunakan tindakan di bawah. Setiap plugin dalam setiap projek mempunyai kunci masing‑masing.

Gunakan alamat video atau strim langsung. Alamat YouTube atau halaman web Vimeo bukan fail video langsung. Main semula tidak memerlukan akses kamera atau mikrofon.

Konfigurasi sekali
  1. Buat atau pilih projek aplikasi Bubble anda di BestPlugins → Dashboard → Plugins.
  2. Pilih plugin ini dan salin kunci projeknya.
  3. Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
  4. Tambah elemen, pilih data aplikasi anda dan bina alur kerja di bawah.
  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.
Pemasangan dan langganan

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.

Simpan hasil dalam aplikasi anda

Contoh WatchProgress: owner = Current User, lesson = Selected Lesson, seconds = Video Player's position_seconds, duration = Video Player's duration_seconds. Simpan hanya untuk video yang dipilih kini. Indeks trek milik video tersebut dan tidak seharusnya disimpan sebagai pilihan bahasa tetap.

Kegagalan, pembatalan dan pemulihan

Pada player_error, tunjukkan error_code dan tawarkan Reload video. Ia memuat semula tanpa memulakan main semula. Memilih sumber lain membersihkan pilihan trek lama. Keluar dari pandangan menjeda video; pengguna menekan Play untuk meneruskan.

Keupayaan dan had

Kelajuan: 0.5, 1, 1.5 dan 2. Volum: 0–1. Format: auto, progressive, HLS dan Android‑hanya DASH. Trek yang tersedia bergantung pada fail. Gunakan -1 untuk mematikan trek; -2 bermakna tidak diketahui dan tidak dapat dipilih. Tiada penyuntingan, eksport video, DRM, gambar-dalam-gambar atau cache luar talian tetap.

Tetapan, tindakan dan hasil

Gunakan nama-nama ini dalam Bubble. Ciri yang dirancang ditandakan secara berasingan.

Tetapan beta tersedia

Tetapan elemen

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

Keadaan

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

Acara

source_changedsource_loadedplayback_readyplaying_changedtime_changedendedtracks_changedfullscreen_changedplayer_error

Tindakan dan inputnya

PlayPauseStop and rewindReload videoSeekSet volumeSet mutedSet playback rateEnter fullscreenSelect audio trackSelect subtitle track
Tetapan elemen · 12
source_urltext · Lalai: ""
Nilai contohhttps://bestplugins.online/native-samples/lesson.mp4
Contoh ungkapan BubbleSelected Lesson's video_url
Alamat fail audio, video atau imej yang dipilih. Gunakan jenis fail yang disokong plugin ini.
poster_urltext · Lalai: ""
Nilai contohhttps://bestplugins.online/native-samples/poster.jpg
Contoh ungkapan BubbleSelected Lesson's poster_url
Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.
content_typetext · Lalai: "auto"
Nilai contohauto
Contoh ungkapan BubbleSelected Lesson's video_content_type
Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.
ratenumber · Lalai: 1
Nilai contoh1.5
Contoh ungkapan BubbleSpeed Dropdown's value
Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.
volumenumber · Lalai: 1
Nilai contoh0.8
Contoh ungkapan BubbleVolume Slider's value
Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.
mutedyes/no · Lalai: false
Nilai contohno
Contoh ungkapan BubbleMute Checkbox is checked
Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.
loopyes/no · Lalai: false
Nilai contohno
Contoh ungkapan BubbleSelected Lesson's repeat_enabled
Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.
is_activeyes/no · Lalai: true
Nilai contohyes
Contoh ungkapan BubbleGuideHost's view_is_active (your yes/no custom state)
Tetapkan ya semasa pandangan ini dibuka. Tetapkan tidak apabila keluar, supaya main semula atau kerja semasa dapat dihentikan.
disabledyes/no · Lalai: false
Nilai contohno
Contoh ungkapan BubbleGuideHost's is_busy (your yes/no custom state)
Lumpuhkan elemen semasa aplikasi anda sibuk atau tindakan ini tidak tersedia.
native_controlsyes/no · Lalai: false
Nilai contohno
Contoh ungkapan BubbleApp Settings' use_native_video_controls
Tunjukkan atau sembunyikan kawalan video standard peranti.
ui_text_jsontext · Lalai: "{}"
Nilai contoh{}
Contoh ungkapan BubbleApp Settings' player_labels_json (supported keys only)
JSON pilihan dengan label butang yang disokong. Biarkan kosong untuk menggunakan teks terbina dalam.
languagetext · Lalai: "auto"
Nilai contohuk
Contoh ungkapan BubbleCurrent User's preferred_language
Tetapkan language=auto untuk mengikuti peranti atau bahasa pelayar yang disokong. Masukkan kod bahasa yang disokong untuk memilihnya secara eksplisit.
Tindakan dan inputnya · 11
Play

Tiada parameter tindakan

Pause

Tiada parameter tindakan

Stop and rewind

Tiada parameter tindakan

Reload video

Tiada parameter tindakan

Seek
position_secondsnumber · Lalai: —
Nilai contoh45
Contoh ungkapan BubbleSelected Chapter's start_seconds
Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.
Set volume
volumenumber · Lalai: —
Nilai contoh0.8
Contoh ungkapan BubbleVolume Slider's value
Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.
Set muted
mutedyes/no · Lalai: —
Nilai contohno
Contoh ungkapan BubbleMute Checkbox is checked
Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.
Set playback rate
ratenumber · Lalai: —
Nilai contoh1.5
Contoh ungkapan BubbleSpeed Dropdown's value
Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.
Enter fullscreen

Tiada parameter tindakan

Select audio track
indexnumber · Lalai: —
Nilai contoh0
Contoh ungkapan BubbleSelected row's current_source_index
Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.
Select subtitle track
indexnumber · Lalai: —
Nilai contoh0
Contoh ungkapan BubbleSelected row's current_source_index
Gunakan nilai rekod perniagaan semasa; sahkan ia terhadap had di bawah.
Keadaan dan peristiwa

Keadaan

is_playing · yes/no

Nilai semasa untuk item yang dipilih. Baca selepas acara berkaitan.

is_buffering · yes/no

Nilai semasa untuk item yang dipilih. Baca selepas acara berkaitan.

pending_play · yes/no

Nilai semasa untuk item yang dipilih. Baca selepas acara berkaitan.

is_live · yes/no

Nilai semasa untuk item yang dipilih. Baca selepas acara berkaitan.

muted · yes/no

Nilai semasa untuk item yang dipilih. Baca selepas acara berkaitan.

loop · yes/no

Nilai semasa untuk item yang dipilih. Baca selepas acara berkaitan.

has_source · yes/no

Nilai semasa untuk item yang dipilih. Baca selepas acara berkaitan.

is_fullscreen · yes/no

Nilai semasa untuk item yang dipilih. Baca selepas acara berkaitan.

position_seconds · number

Nilai semasa untuk item yang dipilih. Baca selepas acara berkaitan.

duration_seconds · number

Nilai semasa untuk item yang dipilih. Baca selepas acara berkaitan.

volume · number

Nilai semasa untuk item yang dipilih. Baca selepas acara berkaitan.

rate · number

Nilai semasa untuk item yang dipilih. Baca selepas acara berkaitan.

source_generation · number

Nilai semasa untuk item yang dipilih. Baca selepas acara berkaitan.

selected_audio_index · number

Nilai semasa untuk item yang dipilih. Baca selepas acara berkaitan.

selected_subtitle_index · number

Nilai semasa untuk item yang dipilih. Baca selepas acara berkaitan.

status · text

Keputusan semasa tindakan ini. Gunakan acara penyelesaian yang sepadan sebelum menyimpan kejayaan. idle,loading,readyToPlay,error

audio_tracks_json · text

Nilai semasa untuk item yang dipilih. Baca selepas acara berkaitan.

subtitle_tracks_json · text

Nilai semasa untuk item yang dipilih. Baca selepas acara berkaitan.

error_code · text

Maklumat ralat untuk tindakan terakhir. Tunjukkan mesej bantuan dan tawarkan percubaan semula yang relevan.

error_message · text

Maklumat ralat untuk tindakan terakhir. Tunjukkan mesej bantuan dan tawarkan percubaan semula yang relevan.

Acara

source_changed

Apabila acara ini berlaku, baca keadaan berkaitan dari elemen yang sama.

source_loaded

Apabila acara ini berlaku, baca keadaan berkaitan dari elemen yang sama.

playback_ready

Apabila acara ini berlaku, baca keadaan berkaitan dari elemen yang sama.

playing_changed

Apabila acara ini berlaku, baca keadaan berkaitan dari elemen yang sama.

time_changed

Apabila acara ini berlaku, baca keadaan berkaitan dari elemen yang sama.

ended

Apabila acara ini berlaku, baca keadaan berkaitan dari elemen yang sama.

tracks_changed

Apabila acara ini berlaku, baca keadaan berkaitan dari elemen yang sama.

fullscreen_changed

Apabila acara ini berlaku, baca keadaan berkaitan dari elemen yang sama.

player_error

Apabila acara ini berlaku, baca keadaan berkaitan dari elemen yang sama.

Soalan yang ditanya pembangun

Bolehkah saya mengeksport segmen terpilih?

Tidak. Seek dan skrin penuh mengubah main semula, bukan bait video.

Bagaimana langganan berfungsi?

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.

Panduan berkaitan

Untuk bantuan, beritahu kami plugin dan peranti yang anda gunakan, tindakan yang anda cuba serta apa yang terjadi. Gunakan contoh tanpa data peribadi. Jangan sekali-kali kongsikan kunci atau fail peribadi anda.