Xodera Plugins · Bubble Native
Xodera Audio Recorder 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
Практични примери
Слушајте пред да испратите неповерлива гласовна порака
Корисниците треба да имаат можност да ја слушаат и заменат снимката пред да стане прилог.
`title = the app’s conversation label`; поставете `max_duration_seconds` и `max_upload_bytes` во вашата политика за пораки.
Start recording → Stop recording → почекајте `recording_ready` → Play preview. Понудете Seek preview и Set preview speed. Само експлицитното Send ја повикува Upload to Bubble на прифатената адреса за поставување на вашата сопствена апликација.
Само на `upload_succeeded`, создадете свој Message и поставете го неговото аудиополе на `uploaded_file`. Самиот снимач не ја создава пораката.
При одбивање на микрофонот прикажете `permission_status`; при неуспешно поставување задржете ја локалната снимка. Проверете го резултатот од непознатото поставување пред повторен обид, за да „Send“ не може да создаде дупли прилози/пораки.
Bubble поставувањето создава јавен аудио фајл. Не користете го ова поставување за поверливи снимки.
Вежба за изговор без непосредно поставување
Учениците сакаат да ја споредат својата говорна реакција со лекција пред да одлучат да ја поднесат.
`title = Current Exercise’s prompt`; `max_duration_seconds = the exercise limit`; одговорот на вежбата останува запис во сопственост на апликацијата.
Record → Stop → Play preview. Дозволете му на ученикот да се премести на друго место во снимката, да го забави прегледот или да откаже и да сними нов обид. Користете Save locally само кога ќе избере да го задржи нацртот.
`duration`, `local_uri`, `mime_type` и `draft_id` ги опишуваат обидот. Вашата апликација одлучува дали ќе остане локално или подоцна ќе се поднесе преку избраниот процес за поставување.
На `preview_error`, зачувајте го нацртот и прикажете `error_code`. Не претворајте преглед или зачуван нацрт во поднесен Answer додека процесот за поднесување во апликацијата не заврши успешно.
Bubble поставувањето создава јавен аудио фајл. Не користете го ова поставување за поверливи снимки.
Зачувајте локален гласовен нацрт и направете „Send“ изричен
Теренскиот работник може да биде прекинат пред да заврши белешка и не треба да мора да ја постави само за да ја задржи.
`saved_draft_id = the draft ID stored by your app for this device and account`; `title = the selected non-sensitive task label`.
Start/Stop recording → Save locally. Зачувајте го вратениот `draft_id` во сопствена состојба ограничена на конкретниот уред и сметка. Користете Restore local draft за истиот ID, потоа Play preview пред да одлучите дали да ја поставите снимката.
На `local_saved` или `local_restored`, проверете `is_saved_locally`, `local_uri` и `duration`. Само избришете го зачуваниот нацрт по изрична избор на корисникот или по одделно потврдена политика за задржување.
Ако обновувањето не успее, прикажете `error_code` и задржете го ID‑от за дијагноза; не пријавувајте празна или различна снимка како обновена. Никогаш не правете auto‑поставување при повторно поврзување.
Bubble поставувањето создава јавен аудио фајл. Не користете го ова поставување за поверливи снимки.
Што работи сега
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. Заменете ги со вашите типови податоци и имиња на елементи. Примерните медиумски адреси мора да се заменат со вашите датотеки.
Додајте го рекордерот. Поставете document_context = Current User's unique id и is_active според тоа дали приказот за снимање е отворен.
Start recording бара дозвола за микрофон. Pause и Resume ја задржуваат истата снимка. Stop recording ја завршува; почекајте recording_ready пред да понудите преглед или поставување.
Користете ги контролите за преглед за да слушате. Save locally задржува нацрт на овој уред; по local_saved, задржете draft_id за Restore local draft.
Објаснете дека испраќањето создава јавна датотека. Поставете bubble_upload_url на вашата сопствена Bubble апликација со точната Development или Live адреса за поставување на датотеки. Извршете Upload to Bubble само кога корисникот избира Испрати; на upload_succeeded, зачувајте uploaded_file во вашата евиденција.
Конфигурирајте еднаш
Создајте или изберете го вашиот Bubble апликациски проект во BestPlugins → Dashboard → Plugins. Изберете Xodera Audio Recorder Native, копирајте го неговиот клуч, потоа отворете Bubble → Plugins → Xodera Audio Recorder Native и вметнете го во licensing_api_key. Снимете еднаш; потоа користете ги акциите подолу. Секој додаток во секој проект има свој клуч.
Побарајте дозвола за микрофон кога корисникот започнува снимање. Изберете како апликацијата ќе ги зачувува нацртите. Bubble поставување складира јавна датотека, па користете го само за аудио соодветно за јавно складирање.
Конфигурирајте еднаш
- Создајте или изберете го вашиот 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.
Зачувајте го резултатот во вашата апликација
По upload_succeeded, поставете VoiceMessage.audio = Recorder's uploaded_file, owner = Current User, duration = Recorder's duration и mime_type = Recorder's mime_type. draft_id го враќа нацртот на овој уред; тоа не е онлајн аудио датотека.
Неуспех, откажување и опоравок
Ако пристапот до микрофонот е одбиен, објаснете како да се овозможи во поставките на уредот. Cancel recording отфрла несочуваното снимање; зачуваните нацрти остануваат. Ако поставувањето е прекинато, задржете ја локалната снимка и проверете дали датотеката пристигна пред повторно испраќање. Delete saved draft го отстранува само избраниот зачуван нацрт.
Можности и ограничувања
Стандардно максимално траење на снимањето: 300 секунди; може да се постави во опсегот 1–3600. Стандардно ограничување за поставување: 10 MiB; максимум 30 MiB. Временско ограничување за поставување: 60 секунди, без автоматски повторен обид. Поставувањата во Bubble се јавни. Поддржани се само вашите сопствени *.bubbleapps.io адреси за поставување датотеки; сопствени домени не се поддржани. Локалните нацрти не се шифрирано складиште.
Подесувања, акции и резултати
Користете ги овие имиња во Bubble. Планираните функции се означени посебно.
Достапни бета поставки
Подесувања на елементот
title · textmax_duration_seconds · numbermax_upload_bytes · numberis_active · yes_nodisabled · yes_noui_text_json · textsaved_draft_id · textbubble_upload_url · textlanguage · textdocument_context · textСостојби
recorder_status · textpermission_status · textis_recording · yes_nois_paused · yes_noduration · numberlocal_uri · textdraft_id · textis_saved_locally · yes_nomime_type · textfile_size · numberwaveform_peaks_json · textpreview_status · textpreview_is_playing · yes_nopreview_current_time · numberupload_status · textupload_progress · numberuploaded_url · textuploaded_file · fileerror_code · textНастани
recording_startedrecording_pausedrecording_resumedrecording_stoppedrecording_readyrecording_cancelledrecorder_errorlocal_savedlocal_restoredlocal_deletedupload_succeededupload_failedupload_cancelledpreview_readypreview_errorАкции и нивните влезови
Start recordingPause recordingResume recordingStop recordingCancel recordingSave locallyRestore local draftDelete saved draftUpload to BubbleCancel uploadPlay previewPause previewStop previewSeek previewSet preview speedПодесувања на елементот · 10
titletext · Стандардно: ""- Примерна вредност
Lesson 4 — review - Пример Bubble израз
Selected Lesson's name - Видлив текст на апликацијата; празно користи вграден локализиран текст каде што е поддржано. Без акредитиви.
max_duration_secondsnumber · Стандардно: 300- Примерна вредност
300 - Пример Bubble израз
Voice Settings' max_seconds - Користете ја вредноста од тековниот деловен запис; проверете ја според ограничувањата подолу.
max_upload_bytesnumber · Стандардно: 10485760- Примерна вредност
10485760 - Пример Bubble израз
Voice Settings' max_upload_bytes - Користете ја вредноста од тековниот деловен запис; проверете ја според ограничувањата подолу.
is_activeyes_no · Стандардно: true- Примерна вредност
yes - Пример Bubble израз
GuideHost's view_is_active (your yes/no custom state) - Поставете да доколку овој поглед е отворен. Поставете не кога се напушта, за да се застане репродукцијата или тековната работа.
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 со поддржани натписи на копчиња. Оставете празно за да се користи вграден текст.
saved_draft_idtext · Стандардно: ""- Примерна вредност
<returned draft_id> - Пример Bubble израз
Selected VoiceDraft's draft_id - Користете ја вредноста од тековниот деловен запис; проверете ја според ограничувањата подолу.
bubble_upload_urltext · Стандардно: ""- Примерна вредност
https://your-app.bubbleapps.io/version-test/fileupload - Пример Bubble израз
App Settings' selected_bubble_upload_url - Вашата сопствена Bubble адреса за поставување на датотеки: /version-test/fileupload за Development, /fileupload за Live. Ова поставување создава јавни датотеки.
languagetext · Стандардно: "auto"- Примерна вредност
uk - Пример Bubble израз
Current User's preferred_language - Поставете language=auto за да се следи поддржан јазик на уредот или прелистувачот. Внесете поддржан јазичен код за да го изберете јазикот експлицитно.
document_contexttext · Стандардно: ""- Примерна вредност
<current-user-id> - Пример Bubble израз
Current User's unique id - Стабилна вредност за оваа сметка или запис. Користете ја истата вредност при враќање на нејзините зачувани датотеки или нацрти.
Акции и нивните влезови · 15
Start recording
Нема параметри за дејство
Pause recording
Нема параметри за дејство
Resume recording
Нема параметри за дејство
Stop recording
Нема параметри за дејство
Cancel recording
Нема параметри за дејство
Save locally
Нема параметри за дејство
Restore local draft
draft_idtext · Стандардно: —- Примерна вредност
<returned draft_id> - Пример Bubble израз
Selected VoiceDraft's draft_id - Користете ја вредноста од тековниот деловен запис; проверете ја според ограничувањата подолу.
Delete saved draft
draft_idtext · Стандардно: —- Примерна вредност
<returned draft_id> - Пример Bubble израз
Selected VoiceDraft's draft_id - Користете ја вредноста од тековниот деловен запис; проверете ја според ограничувањата подолу.
Upload to Bubble
Нема параметри за дејство
Cancel upload
Нема параметри за дејство
Play preview
Нема параметри за дејство
Pause preview
Нема параметри за дејство
Stop preview
Нема параметри за дејство
Seek preview
secondsnumber · Стандардно: —- Примерна вредност
12 - Пример Bubble израз
Selected Comment's seconds - Користете ја вредноста од тековниот деловен запис; проверете ја според ограничувањата подолу.
Set preview speed
ratenumber · Стандардно: —- Примерна вредност
1.5 - Пример Bubble израз
Preview Speed Dropdown's value - Користете ја вредноста од тековниот деловен запис; проверете ја според ограничувањата подолу.
Состојби и настани
Состојби
recorder_status · textТековен резултат на оваа акција. Користете соодветен настан за завршување пред да зачувате успех.
permission_status · textТековен резултат на оваа акција. Користете соодветен настан за завршување пред да зачувате успех.
is_recording · yes_noТековна вредност за избраниот елемент. Прочитајте ја по поврзаниот настан.
is_paused · yes_noТековна вредност за избраниот елемент. Прочитајте ја по поврзаниот настан.
duration · numberТековна вредност за избраниот елемент. Прочитајте ја по поврзаниот настан.
local_uri · textЛокација на датотеката на овој уред. Зачувајте или поставете датотеката посебно ако треба да остане онлајн.
draft_id · textИдентификатор за оваа ставка или акција. Задржете го со соодветниот запис во апликацијата. Користете истиот идентификатор за барање при повторен обид на несигурен резултат.
is_saved_locally · yes_noТековна вредност за избраниот елемент. Прочитајте ја по поврзаниот настан.
mime_type · textТековна вредност за избраниот елемент. Прочитајте ја по поврзаниот настан.
file_size · numberТековна вредност за избраниот елемент. Прочитајте ја по поврзаниот настан.
waveform_peaks_json · textТековна вредност за избраниот елемент. Прочитајте ја по поврзаниот настан.
preview_status · textТековен резултат на оваа акција. Користете соодветен настан за завршување пред да зачувате успех.
preview_is_playing · yes_noТековна вредност за избраниот елемент. Прочитајте ја по поврзаниот настан.
preview_current_time · numberТековна вредност за избраниот елемент. Прочитајте ја по поврзаниот настан.
upload_status · textТековен резултат на оваа акција. Користете соодветен настан за завршување пред да зачувате успех.
upload_progress · numberТековна вредност за избраниот елемент. Прочитајте ја по поврзаниот настан.
uploaded_url · textТековна вредност за избраниот елемент. Прочитајте ја по поврзаниот настан.
uploaded_file · fileДатотека вратена по upload_succeeded. Зачувајте ја во вашето поле од типот Bubble File.
error_code · textИнформации за грешка за последната акција. Прикажете корисна порака и понудете соодветен повторен обид.
Настани
recording_startedКога се случи овој настан, прочитајте ги поврзаните состојби од истиот елемент.
recording_pausedКога се случи овој настан, прочитајте ги поврзаните состојби од истиот елемент.
recording_resumedКога се случи овој настан, прочитајте ги поврзаните состојби од истиот елемент.
recording_stoppedКога се случи овој настан, прочитајте ги поврзаните состојби од истиот елемент.
recording_readyКога се случи овој настан, прочитајте ги поврзаните состојби од истиот елемент.
recording_cancelledКога се случи овој настан, прочитајте ги поврзаните состојби од истиот елемент.
recorder_errorКога се случи овој настан, прочитајте ги поврзаните состојби од истиот елемент.
local_savedКога се случи овој настан, прочитајте ги поврзаните состојби од истиот елемент.
local_restoredКога се случи овој настан, прочитајте ги поврзаните состојби од истиот елемент.
local_deletedКога се случи овој настан, прочитајте ги поврзаните состојби од истиот елемент.
upload_succeededКога се случи овој настан, прочитајте ги поврзаните состојби од истиот елемент.
upload_failedКога се случи овој настан, прочитајте ги поврзаните состојби од истиот елемент.
upload_cancelledКога се случи овој настан, прочитајте ги поврзаните состојби од истиот елемент.
preview_readyКога се случи овој настан, прочитајте ги поврзаните состојби од истиот елемент.
preview_errorКога се случи овој настан, прочитајте ги поврзаните состојби од истиот елемент.
Прашања што ги поставуваат развивачите
Дали локалното зачувување поставува снимката?
Не. Save locally задржува нацрт на сопствениот уред. Upload to Bubble е посебна експлицитна јавна операција.
Како функционира претплатата?
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.
Поврзани упатства
За помош, кажете ни кој приклучок и уред користите, која акција ја испробавте и што се случи. Користете пример без лични податоци. Никогаш не споделувајте го вашиот клуч или приватни датотеки.