Audio Player saskarne ar piemēra nosaukumu.

Xodera Plugins · Bubble Native

Xodera Audio Player Native

Pievienojiet skaidru audio atskaņotāju nodarbībām, balss ziņojumiem vai produktu ierakstiem. Ļaujiet lietotājiem klausīties, mainīt ātrumu un turpināt no saglabātās vietas.

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.

Izveidojiet darbplūsmu ↓Spraudņa iestatījumi ↗Native Lab

Dokumentācija pārskatīta 6 novembrī 2026

Praktiski piemēri

Balss piezīmes atbalsta sarunā

Vienkārša faila saite novirza lietotājus no sarunas un apgrūtina garu atbilžu pārskatīšanu.

`source_url = Selected Message’s audio URL`; `title = Selected Message’s sender label`; `subtitle = Selected Message’s timestamp`.

Novietojiet atskaņotāju izvēlētās ziņas detaļā. Ļaujiet lietotājam Play/Pause, Seek līdz noderīgam punktam un Set speed. Saistiet `is_active` ar atvērtu sarunu.

Izmantojiet `is_playing`, `current_time` un `duration`, lai parādītu progresu. Saglabājiet Message ID savā lietotnē, lai novēlājs notikums nevarētu atjaunināt citu sarunu.

Kad `player_error`, parādiet `error_code` un piedāvājiet Reload source; saglabājiet ziņu un nekad neatzīmējiet to kā noklausītu pēc kļūdas.

Tikai atskaņošana. Jūsu lietotne saglabā klausīšanās progresu.

Atsākt valodas nodarbību saglabātajā pozīcijā

Mācībniekiem jāatskaņo grūts fragments, nevis jāatsāk visa nodarbība.

`source_url = Current Lesson’s audio URL`; `title = Current Lesson’s name`; pēdējā pozīcija pieder tam mācībniekam un nodarbībai jūsu datubāzē.

Pēc `ready` pašreizējai nodarbībai, Seek uz saglabātajām sekundēm un gaidiet, līdz lietotājs Play. Izmantojiet Set speed lēnākiem klausīšanās režīmiem. Saglabājiet progresu ar savas lietotnes darbplūsmu.

Izlasiet `current_time` un `duration`. Kad `playback_ended`, jūsu lietotne var ierakstīt klausīšanās posmu pašreizējam Lesson.

Ja avots ir mainīts, izmestiet veco pozīciju, līdz nodarbība ir ielādēta. Neuzskatiet klausīšanās pabeigšanu par pierādījumu, ka mācībnieks ir sapratis vai nokārtojis testu.

Tikai atskaņošana. Jūsu lietotne saglabā klausīšanās progresu.

Pārskatiet audio pielikumu ar laika zīmogu komentāriem

Redaktoriem vai treneriem jālec no komentāra uz attiecīgo brīdi ierakstā.

`source_url = Selected Review’s recording URL`; katrs lietotnes īpašais komentārs saglabā savu sekunžu vērtību; izvēles `waveform_peaks_json` satur īstas virsotnes tam pašam ierakstam.

Klikšķiniet uz komentāra → Seek uz tā sekundēm → Play. Mainot avotu, aizstājiet vai notīriet virsotnes un atkal saistiet izvēlēto pārskatīšanu.

Parādiet `current_time` blakus jūsu komentāru rakstītājam. `waveform_available` informē jūsu UI, vai ir pieejamas faktiski piegādātās virsotnes.

Ierobežojiet vai atmetiet novecojušus laika zīmogus pret pašreizējo ilgumu jūsu lietotnē. Ja nav īstu virsotņu, rādiet parasto progresa vadīklu, nevis izdomātu audio analīzi.

Tikai atskaņošana. Jūsu lietotne saglabā klausīšanās progresu.

Kas pašlaik darbojas

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.

Izveidojiet darbplūsmu

Izmantojiet zemāk pieejamās beta darbības un pārbaudiet rezultātu savās mērķierīcēs.

Šie piemēri izmanto lietotnes ierakstus, piemēram, Lesson, Message un Order. Aizstājiet tos ar saviem datu tipiem un elementu nosaukumiem. Piemēru multivides adreses jāaizstāj ar jūsu failiem.

Pievienojiet audio elementu. Iestatiet source_url = Selected Message's audio_url, title = Selected Message's sender_label un subtitle = Selected Message's date_label.
Ja jums ir īsti viļņu formas dati šim ierakstam, nododiet tos waveform_peaks_json. Pretējā gadījumā atstājiet tukšu.
Kad notiek ready, izmantojiet Seek ar saglabāto sekunžu skaitu, ja nepieciešams. Ļaujiet lietotājam nospiest Play. Izmantojiet Pause, Seek un Set speed atkaņotāja pogām.
Parādiet current_time un duration. Uz playback_ended saglabājiet klausīšanās progresu izvēlētajai ziņai vai nodarbībai. Iestatiet is_active uz to, vai šis skats ir atvērts.

Darba plūsmas diagramma — ne lietotnes ekrānuzņēmums

Konfigurējiet vienreiz

Izveidojiet vai izvēlieties savu Bubble lietotnes projektu vietnē BestPlugins → Dashboard → Plugins. Izvēlieties Xodera Audio Player Native, nokopējiet tā atslēgu, pēc tam atveriet Bubble → Plugins → Xodera Audio Player Native un ielīmējiet to licensing_api_key. Saglabājiet vienreiz; pēc tam izmantojiet zemāk redzamās darbības. Katram spraudnim katrā projektā ir sava atslēga.

Izmantojiet tiešu audio faila adresi, ko lietotne var atvērt. Audio atskaņošana neprasa mikrofonu vai kameras piekļuvi.

Konfigurējiet vienreiz

Izveidojiet vai izvēlieties savu Bubble lietotnes projektu vietnē BestPlugins → Dashboard → Plugins.
Izvēlieties šo spraudni un nokopējiet tā projekta atslēgu.
Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
Pievienojiet elementu, izvēlieties savus lietotnes datus un izveidojiet zemāk redzamo darbplūsmu.
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.

Instalēšana un abonements

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.

Saglabājiet rezultātu savā lietotnē

Piemērs ListeningProgress: owner = Current User, lesson = Selected Lesson, seconds = Audio Player's current_time, duration = Audio Player's duration. Saglabājiet, kad lietotājs pauzē vai pamet nodarbību, nevis pie katras ekrāna atjaunināšanas.

Kļūda, atcelšana un atjaunošana

Uz player_error parādiet error_code un piedāvājiet Reload source. Saglabājiet ziņas vai nodarbības ierakstu. Kad tiek izvēlēts cits ieraksts, ielādējiet tā saglabāto pozīciju. Atgriežoties skatā, atskaņošana netiek automātiski sākta.

Iespējas un ierobežojumi

Atkaņošanas ātrumi: 1, 1.5 un 2. Skaļums: 0–1. Viļņu formas dati: 2–2048 vērtības starp 0 un 1. Atbalstītie audio formāti ir atkarīgi no ierīces. Atskaņotājs neieraksta un netranskribē audio, kā arī nesaglabā to pastāvīgi lietošanai bezsaistē. Fonā un bloķēšanas ekrānā atskaņošana nav garantēta.

Iestatījumi, darbības un rezultāti

Izmantojiet šos nosaukumus Bubble. Plānotās funkcijas ir atzīmētas atsevišķi.

Pieejamie beta iestatījumi

Elementa iestatījumi

source_url · textwaveform_peaks_json · texttitle · textsubtitle · textplayback_rate · numbervolume · numberloop · yes_nois_active · yes_nodisabled · yes_noui_text_json · textlanguage · text

Stāvokļi

player_status · textis_playing · yes_nois_loaded · yes_nois_buffering · yes_nocurrent_time · numberduration · numberprogress · numberplayback_rate · numbervolume · numberis_looping · yes_nowaveform_available · yes_nowaveform_status · texterror_code · text

Notikumi

readyplayback_startedplayback_pausedplayback_endedseek_completedrate_changedplayer_error

Darbības un to ievades

PlayPauseToggleStopSeekSet speedSet volumeReload source

Elementa iestatījumi · 11

source_urltext · Noklusējums: "": Piemēra vērtībahttps://bestplugins.online/native-samples/lesson.mp3; Piemērs Bubble izteiksmeiSelected Message's audio_url; Atlasītā audio, video vai attēla faila adrese. Izmantojiet faila tipu, ko šis spraudnis atbalsta.

waveform_peaks_jsontext · Noklusējums: "": Piemēra vērtība[0.1,0.4,0.2,0.7]; Piemērs Bubble izteiksmeiSelected Message's waveform_peaks_json; Īsti normalizētas amplitūdas vērtības šim ierakstam; atstājiet tukšu, ja nav pieejamas.

titletext · Noklusējums: "": Piemēra vērtībaLesson 4 — review; Piemērs Bubble izteiksmeiSelected Lesson's name; Redzams lietotnes teksts; tukšs lieto iebūvēto lokalizēto tekstu, ja tas ir atbalstīts. Nav akreditācijas dati.

subtitletext · Noklusējums: "": Piemēra vērtībaTeacher · today; Piemērs Bubble izteiksmeiSelected Message's sender_label; Redzams lietotnes teksts; tukšs lieto iebūvēto lokalizēto tekstu, ja tas ir atbalstīts. Nav akreditācijas dati.

playback_ratenumber · Noklusējums: 1: Piemēra vērtība1.5; Piemērs Bubble izteiksmeiCurrent User's listening_speed; Izmantojiet pašreizējā biznesa ieraksta vērtību; pārbaudiet to pret zemāk norādītajiem ierobežojumiem.

volumenumber · Noklusējums: 1: Piemēra vērtība0.8; Piemērs Bubble izteiksmeiVolume Slider's value; Izmantojiet pašreizējā biznesa ieraksta vērtību; pārbaudiet to pret zemāk norādītajiem ierobežojumiem.

loopyes_no · Noklusējums: false: Piemēra vērtībano; Piemērs Bubble izteiksmeiSelected Lesson's repeat_enabled; Izmantojiet pašreizējā biznesa ieraksta vērtību; pārbaudiet to pret zemāk norādītajiem ierobežojumiem.

is_activeyes_no · Noklusējums: true: Piemēra vērtībayes; Piemērs Bubble izteiksmeiGuideHost's view_is_active (your yes/no custom state); Iestatiet jā, kamēr šis skats ir atvērts. Iestatiet nē, kad iziet, lai atskaņošana vai pašreizējais darbs varētu apturēties.

disabledyes_no · Noklusējums: false: Piemēra vērtībano; Piemērs Bubble izteiksmeiGuideHost's is_busy (your yes/no custom state); Atspējojiet elementu, kamēr jūsu lietotne ir aizņemta vai šī darbība nav pieejama.

ui_text_jsontext · Noklusējums: "": Piemēra vērtība{}; Piemērs Bubble izteiksmeiApp Settings' player_labels_json (supported keys only); Papildu JSON ar atbalstītām pogu etiķetēm. Atstājiet tukšu, lai izmantotu iebūvēto tekstu.

languagetext · Noklusējums: "auto": Piemēra vērtībauk; Piemērs Bubble izteiksmeiCurrent User's preferred_language; Iestatiet language=auto, lai sekotu atbalstītai ierīcei vai pārlūkprogrammas valodai. Ievadiet atbalstītu valodas kodu, lai to izvēlētos tieši.

Darbības un to ievades · 8

Play

Nav darbības parametru

Pause

Nav darbības parametru

Toggle

Nav darbības parametru

Stop

Nav darbības parametru

Seek

secondsnumber · Noklusējums: —: Piemēra vērtība12; Piemērs Bubble izteiksmeiSelected Comment's seconds; Izmantojiet pašreizējā biznesa ieraksta vērtību; pārbaudiet to pret zemāk norādītajiem ierobežojumiem.

Set speed

ratenumber · Noklusējums: —: Piemēra vērtība1.5; Piemērs Bubble izteiksmeiSpeed Dropdown's value; Izmantojiet pašreizējā biznesa ieraksta vērtību; pārbaudiet to pret zemāk norādītajiem ierobežojumiem.

Set volume

volumenumber · Noklusējums: —: Piemēra vērtība0.8; Piemērs Bubble izteiksmeiVolume Slider's value; Izmantojiet pašreizējā biznesa ieraksta vērtību; pārbaudiet to pret zemāk norādītajiem ierobežojumiem.

Reload source

Nav darbības parametru

Stāvokļi un notikumi

Stāvokļi

player_status · text

Pašreizējais šīs darbības rezultāts. Izmantojiet atbilstošo pabeigšanas notikumu pirms saglabājat veiksmi.

is_playing · yes_no