Xodera Plugins · Bubble Native
Xodera Audio Player Native
დაამატეთ სუფთა აუდიო დამკვრელი გაკვეთილებში, ხმოვან შეტყობინებებში ან პროდუქტის ჩანაწერებში. მომხმარებლებს შეეძლება მოსმენა, სიჩქარის შეცვლა და შენახული ადგილიდან გაგრძელება.
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.
დოკუმენტაცია გადახედულია 6 ნოემბერი 2026
პრაქტიკული მაგალითები
ხმოვანი შენიშვნები მხარდაჭერის საუბარში
მარტივი ფაილის ბმული გადაგზავნის მომხმარებლებს საუბრიდან და გრძელ პასუხებს რთულად გადახედავს.
`source_url = Selected Message’s audio URL`; `title = Selected Message’s sender label`; `subtitle = Selected Message’s timestamp`.
დაყენეთ დამკვრელი არჩეული-შეტყობინების დეტალში. დაუშვით მომხმარებელს Play/Pause, Seek სასარგებლო წერტილამდე და Set speed. მიბანდეთ `is_active` ღია საუბარზე.
პროგრესის საჩვენებლად გამოიყენეთ `is_playing`, `current_time` და `duration`. თქვენს აპში შეინახეთ Message ID, რათა დაგვიანებულმა მოვლენამ სხვა საუბარი ვერ განაახლოს.
`player_error`-ზე, აჩვენეთ `error_code` და შემოთავაზეთ Reload source; შეინარჩუნეთ შეტყობინება და არასოდეს მონიშნოთ, რომ ის მოსმენა მოხდა შეცდომის შემდეგ.
მხოლოდ დაკვრა. თქვენი აპი ინახავს მოსმენის პროგრესს.
განაგრძეთ ენის გაკვეთილი შენახული პოზიციიდან
მოსწავლეებს რთული მონაკვეთის ხელახლა მოსმენა სჭირდებათ, მთელი გაკვეთილის თავიდან დაწყების ნაცვლად.
`source_url = Current Lesson’s audio URL`; `title = Current Lesson’s name`; ბოლო პოზიცია თქვენს მონაცემთა ბაზაში სწორედ ამ მოსწავლესა და გაკვეთილს ეკუთვნის.
მიმდინარე გაკვეთილისთვის `ready`-ის შემდეგ, Seek შენახულ წამებში და დაელოდეთ მომხმარებელს Play. გამოიყენეთ Set speed უფრო ნელი მოსმენისთვის. შენახეთ პროგრესი თქვენი აპის სამუშაო ნაკადით.
წაიკითხეთ `current_time` და `duration`. `playback_ended`-ზე, თქვენი აპი შეიძლება ჩაიწეროს მოსმენის მნიშვნელოვანი წერტილი მიმდინარე Lesson-სთვის.
თუ წყარო შეიცვალა, გაუქმეთ ძველი პოზიცია, სანამ გაკვეთილი არ ჩაიტვირთება. არ ითვლეთ მოსმენის დასრულება დამადასტურებლად, რომ მოსწავლემ მასალა გაიგო ან გამოცდა ჩააბარა.
მხოლოდ დაკვრა. თქვენი აპი ინახავს მოსმენის პროგრესს.
განიხილეთ აუდიო დანართი დროის ნიშნული კომენტარებით
რედაქტორებს ან ტრენერებს საჭიროა გადახტომა კომენტარიდან შესაბამისი მომენტზე ჩანაწერში.
`source_url = Selected Review’s recording URL`; აპის კუთვნილი თითოეული Comment ჩანაწერი ინახავს საკუთარ დროს წამებში; არასავალდებულო `waveform_peaks_json` შეიცავს სწორედ ამავე ჩანაწერის ტალღის ფორმის რეალურ პიკებს.
დააწკაპეთ კომენტარზე → Seek მისი წამებზე → Play. წყაროს შეცვლისას, შეცვალეთ ან გასუფთავეთ პიკები და თავიდან მიბანდეთ არჩეული მიმოხილვა.
გამოჩნდეს `current_time` თქვენი კომენტარის კომპოზიტორის გვერდით. `waveform_available` აჩვენებს UI-ს, არის თუ არა რეალურად მიწოდებული პიკები.
თქვენს აპში მოძველებული დროის ნიშნულები მიმდინარე ხანგრძლივობის დიაპაზონში მოაქციეთ ან უარყავით. თუ რეალური პიკები არ არსებობს, აჩვენეთ ჩვეულებრივი პროგრესის კონტროლი და არა გამოგონილი აუდიოანალიზი.
მხოლოდ დაკვრა. თქვენი აპი ინახავს მოსმენის პროგრესს.
რას მუშაობს ახლა
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.
შექმენით სამუშაო ნაკადი
გამოიყენეთ ქვემოთ მოცემული ბეტა მოქმედებები და გამოცადეთ შედეგი თქვენი სამიზნე მოწყობილობებზე.
ამ მაგალითებში გამოიყენება აპის ჩანაწერები, როგორიცაა Lesson, Message და Order. შეცვალეთ ისინი თქვენი მონაცემის ტიპებით და ელემენტის სახელებით. მაგალითი მედია მისამართები უნდა შეცვალოთ თქვენი ფაილებისით.
დაამატეთ აუდიო ელემენტი. დააყენეთ source_url = Selected Message's audio_url, title = Selected Message's sender_label და subtitle = Selected Message's date_label.
თუ გაქვთ რეალური waveform მონაცემები ამ ჩანაწერისთვის, გადმოიტანეთ ისინი waveform_peaks_json-ში. სხვა შემთხვევაში დატოვეთ ცარიელი.
როდესაც ready მოვლენა მოხდება, გამოიყენეთ Seek შენახული წამების რაოდენობით, თუ საჭიროა. მომხმარებელს დაუშვით დააჭიროს Play. გამოიყენეთ Pause, Seek და Set speed დამკვრელის ღილაკებისთვის.
აჩვენეთ current_time და duration. playback_ended-ზე შეინახეთ მოსმენის პროგრესი არჩეული შეტყობინებისთვის ან გაკვეთილისთვის. is_active-ის მნიშვნელობა უნდა ასახავდეს, ღიაა თუ არა ეს ხედი.
კონფიგურაცია ერთხელ
შექმენით ან აირჩიეთ თქვენი Bubble აპის პროექტი BestPlugins → Dashboard → Plugins-ში. აირჩიეთ Xodera Audio Player Native, დაკოპირეთ მისი გასაღები, შემდეგ გახსენით Bubble → Plugins → Xodera Audio Player Native და ჩასვით იგი licensing_api_key-ში. შეინახეთ ერთხელ; შემდეგ გამოიყენეთ ქვემოთ მოცემული მოქმედებები. თითოეულ პროექტში თითოეული პლაგინი თავისი გასაღებს აქვს.
გამოიყენეთ პირდაპირი აუდიო‑ფაილის მისამართი, რომელსაც აპლიკაცია შეუძლია გახსნათ. აუდიოს დაკვრა არ მოითხოვს მიკროფონის ან კამერის წვდომას.
კონფიგურაცია ერთხელ
- შექმენით ან აირჩიეთ თქვენი Bubble აპის პროექტი BestPlugins → Dashboard → Plugins-ში.
- აირჩიეთ ეს პლაგინი და დაკოპირეთ მისი პროექტის გასაღები.
- Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
- დაამატეთ ელემენტი, აირჩიეთ თქვენი აპის მონაცემები და შექმენით ქვემოთ მოცემული სამუშაო ნაკადი.
- 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.
დაყენება და გამოწერა
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.
შენახეთ შედეგი თქვენს აპლიკაციაში
მაგალითი ListeningProgress: owner = Current User, lesson = Selected Lesson, seconds = Audio Player's current_time, duration = Audio Player's duration. შეინახეთ, როდესაც მომხმარებელი შეჩერებს ან დატოვებს გაკვეთილს, არა ყოველ ეკრანის განახლებაზე.
შეცდომა, გაუქმება და აღდგენა
player_error-ზე, აჩვენეთ error_code და შემოთავაზეთ Reload source. შეინარჩუნეთ შეტყობინება ან გაკვეთილის ჩანაწერი. როდესაც სხვა ჩანაწერი არჩეულია, ჩაიტვირთოს მისი შენახული პოზიცია. ხედში დაბრუნება ავტომატურად არ იწყებს დაკვრას.
შესაძლებლობები და შეზღუდვები
დაკვრის სიჩქარეები: 1, 1.5 და 2. ხმა: 0–1. ტალღის ფორმის მონაცემები: 2–2048 მნიშვნელობა 0-სა და 1-ს შორის. მხარდაჭერილი აუდიო ფორმატები დამოკიდებულია მოწყობილობაზე. დამკვრელი არ იწერს, არ ტრანსკრიბირებს და არ ინახავს აუდიოს მუდმივად ოფლაინ გამოყენებისთვის. ფონი და ბლოკის-ეკრანის დაკვრა არ არის გარანტირებული.
პარამეტრები, მოქმედებები და შედეგები
გამოიყენეთ ეს სახელები Bubble-ში. დაგეგმილი ფუნქციები ცალკე მონიშნულია.
ხელმისაწვდომი ბეტა პარამეტრები
ელემენტის პარამეტრები
source_url · textwaveform_peaks_json · texttitle · textsubtitle · textplayback_rate · numbervolume · numberloop · yes_nois_active · yes_nodisabled · yes_noui_text_json · textlanguage · textმდგომარეობები
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მოვლენები
readyplayback_startedplayback_pausedplayback_endedseek_completedrate_changedplayer_errorმოქმედებები და მათი შეყვანები
PlayPauseToggleStopSeekSet speedSet volumeReload sourceელემენტის პარამეტრები · 11
source_urltext · ნაგულისხმევი: ""- მაგალითი მნიშვნელობა
https://bestplugins.online/native-samples/lesson.mp3 - მაგალითი Bubble გამოსახულება
Selected Message's audio_url - არჩეული აუდიო, ვიდეო ან სურათის ფაილის მისამართი. გამოიყენეთ ფაილის ტიპი, რომელსაც ეს პლაგინი უჭერს მხარს.
waveform_peaks_jsontext · ნაგულისხმევი: ""- მაგალითი მნიშვნელობა
[0.1,0.4,0.2,0.7] - მაგალითი Bubble გამოსახულება
Selected Message's waveform_peaks_json - რეალური ნორმალიზებული ამპლიტუდის მნიშვნელობები ამ ჩანაწერისთვის; დატოვეთ ცარიელი, თუ მიუწვდომელია.
titletext · ნაგულისხმევი: ""- მაგალითი მნიშვნელობა
Lesson 4 — review - მაგალითი Bubble გამოსახულება
Selected Lesson's name - აპში ხილული ტექსტი; ცარიელი მნიშვნელობისას გამოიყენება ჩაშენებული ლოკალიზებული ტექსტი, სადაც ეს მხარდაჭერილია. არ შეიყვანოთ ავტორიზაციის საიდუმლო მონაცემები.
subtitletext · ნაგულისხმევი: ""- მაგალითი მნიშვნელობა
Teacher · today - მაგალითი Bubble გამოსახულება
Selected Message's sender_label - აპში ხილული ტექსტი; ცარიელი მნიშვნელობისას გამოიყენება ჩაშენებული ლოკალიზებული ტექსტი, სადაც ეს მხარდაჭერილია. არ შეიყვანოთ ავტორიზაციის საიდუმლო მონაცემები.
playback_ratenumber · ნაგულისხმევი: 1- მაგალითი მნიშვნელობა
1.5 - მაგალითი Bubble გამოსახულება
Current User's listening_speed - გამოიყენეთ მიმდინარე ბიზნეს-ჩანაწერის მნიშვნელობა; გადამოწმეთ იგი ქვემოთ მოცემული ლიმიტებთან.
volumenumber · ნაგულისხმევი: 1- მაგალითი მნიშვნელობა
0.8 - მაგალითი Bubble გამოსახულება
Volume Slider's value - გამოიყენეთ მიმდინარე ბიზნეს-ჩანაწერის მნიშვნელობა; გადამოწმეთ იგი ქვემოთ მოცემული ლიმიტებთან.
loopyes_no · ნაგულისხმევი: false- მაგალითი მნიშვნელობა
no - მაგალითი Bubble გამოსახულება
Selected Lesson's repeat_enabled - გამოიყენეთ მიმდინარე ბიზნეს-ჩანაწერის მნიშვნელობა; გადამოწმეთ იგი ქვემოთ მოცემული ლიმიტებთან.
is_activeyes_no · ნაგულისხმევი: true- მაგალითი მნიშვნელობა
yes - მაგალითი Bubble გამოსახულება
GuideHost's view_is_active (your yes/no custom state) - დააყენეთ yes, როდესაც ეს ხედია ღია. დააყენეთ no, როდესაც დატოვებთ, რათა დაკვრა ან მიმდინარე სამუშაო შეჩერდეს.
disabledyes_no · ნაგულისხმევი: false- მაგალითი მნიშვნელობა
no - მაგალითი Bubble გამოსახულება
GuideHost's is_busy (your yes/no custom state) - გამორთეთ ელემენტი, როდესაც თქვენი აპი დაკავებულია ან ეს ქმედება მიუწვდომელია.
ui_text_jsontext · ნაგულისხმევი: ""- მაგალითი მნიშვნელობა
{} - მაგალითი Bubble გამოსახულება
App Settings' player_labels_json (supported keys only) - არასავალდებულო JSON მხარდაჭერილი ღილაკების წარწერებით. ჩაშენებული ტექსტის გამოსაყენებლად დატოვეთ ცარიელი.
languagetext · ნაგულისხმევი: "auto"- მაგალითი მნიშვნელობა
uk - მაგალითი Bubble გამოსახულება
Current User's preferred_language - დააყენეთ language=auto, რათა მიყოლოთ მხარდაჭერილი მოწყობილობა ან ბრაუზერის ენა. შეიყვანეთ მხარდაჭერილი ენის კოდი, რათა მას მკაფიოდ აირჩიოთ.
მოქმედებები და მათი შეყვანები · 8
Play
ქმედების პარამეტრები არ არის
Pause
ქმედების პარამეტრები არ არის
Toggle
ქმედების პარამეტრები არ არის
Stop
ქმედების პარამეტრები არ არის
Seek
secondsnumber · ნაგულისხმევი: —- მაგალითი მნიშვნელობა
12 - მაგალითი Bubble გამოსახულება
Selected Comment's seconds - გამოიყენეთ მიმდინარე ბიზნეს-ჩანაწერის მნიშვნელობა; გადამოწმეთ იგი ქვემოთ მოცემული ლიმიტებთან.
Set speed
ratenumber · ნაგულისხმევი: —- მაგალითი მნიშვნელობა
1.5 - მაგალითი Bubble გამოსახულება
Speed Dropdown's value - გამოიყენეთ მიმდინარე ბიზნეს-ჩანაწერის მნიშვნელობა; გადამოწმეთ იგი ქვემოთ მოცემული ლიმიტებთან.
Set volume
volumenumber · ნაგულისხმევი: —- მაგალითი მნიშვნელობა
0.8 - მაგალითი Bubble გამოსახულება
Volume Slider's value - გამოიყენეთ მიმდინარე ბიზნეს-ჩანაწერის მნიშვნელობა; გადამოწმეთ იგი ქვემოთ მოცემული ლიმიტებთან.
Reload source
ქმედების პარამეტრები არ არის
სტატუსები და მოვლენები
მდგომარეობები
player_status · textამ ქმედების მიმდინარე შედეგი. გამოიყენეთ შესაბამისი დასრულების მოვლენა, სანამ შენახავთ წარმატებას.
is_playing · yes_noარჩეული ელემენტის მიმდინარე მნიშვნელობა. წაიკითხეთ იგი დაკავშირებული მოვლენის შემდეგ.
is_loaded · yes_noარჩეული ელემენტის მიმდინარე მნიშვნელობა. წაიკითხეთ იგი დაკავშირებული მოვლენის შემდეგ.
is_buffering · yes_noარჩეული ელემენტის მიმდინარე მნიშვნელობა. წაიკითხეთ იგი დაკავშირებული მოვლენის შემდეგ.
current_time · numberარჩეული ელემენტის მიმდინარე მნიშვნელობა. წაიკითხეთ იგი დაკავშირებული მოვლენის შემდეგ.
duration · numberარჩეული ელემენტის მიმდინარე მნიშვნელობა. წაიკითხეთ იგი დაკავშირებული მოვლენის შემდეგ.
progress · numberარჩეული ელემენტის მიმდინარე მნიშვნელობა. წაიკითხეთ იგი დაკავშირებული მოვლენის შემდეგ.
playback_rate · numberარჩეული ელემენტის მიმდინარე მნიშვნელობა. წაიკითხეთ იგი დაკავშირებული მოვლენის შემდეგ.
volume · numberარჩეული ელემენტის მიმდინარე მნიშვნელობა. წაიკითხეთ იგი დაკავშირებული მოვლენის შემდეგ.
is_looping · yes_noარჩეული ელემენტის მიმდინარე მნიშვნელობა. წაიკითხეთ იგი დაკავშირებული მოვლენის შემდეგ.
waveform_available · yes_noარჩეული ელემენტის მიმდინარე მნიშვნელობა. წაიკითხეთ იგი დაკავშირებული მოვლენის შემდეგ.
waveform_status · textამ ქმედების მიმდინარე შედეგი. გამოიყენეთ შესაბამისი დასრულების მოვლენა, სანამ შენახავთ წარმატებას.
error_code · textშეცდომის ინფორმაცია ბოლო ქმედებისთვის. აჩვენეთ სასარგებლო შეტყობინება და შემოთავაზეთ შესაბამისი ცდა.
მოვლენები
readyროდესაც ეს მოვლენა მოხდება, წაიკითხეთ დაკავშირებული მდგომარეობები იგივე ელემენტიდან.
playback_startedროდესაც ეს მოვლენა მოხდება, წაიკითხეთ დაკავშირებული მდგომარეობები იგივე ელემენტიდან.
playback_pausedროდესაც ეს მოვლენა მოხდება, წაიკითხეთ დაკავშირებული მდგომარეობები იგივე ელემენტიდან.
playback_endedროდესაც ეს მოვლენა მოხდება, წაიკითხეთ დაკავშირებული მდგომარეობები იგივე ელემენტიდან.
seek_completedროდესაც ეს მოვლენა მოხდება, წაიკითხეთ დაკავშირებული მდგომარეობები იგივე ელემენტიდან.
rate_changedროდესაც ეს მოვლენა მოხდება, წაიკითხეთ დაკავშირებული მდგომარეობები იგივე ელემენტიდან.
player_errorროდესაც ეს მოვლენა მოხდება, წაიკითხეთ დაკავშირებული მდგომარეობები იგივე ელემენტიდან.
დეველოპერების კითხვები
აქვს თუ არა იგი waveform-ის შექმნა?
არა. მიწოდეთ რეალური ნორმალიზებული პიკები იმ წყაროსთვის; ჩვეულებრივი პროგრესი მუშაობს მათ გარეშე.
როგორ მუშაობს გამოწერა?
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.
დაკავშირებული გზამკვლევები
დახმარებისთვის, გვაცნობეთ, რომელი პლაგინი და მოწყობილობა იყენებთ, რა მოქმედება სცადეთ და რა მოხდა. გამოიყენეთ მაგალითი პირად მონაცემებს გარეშე. არასოდეს გაუზიაროთ თქვენი გასაღები ან კერძო ფაილები.