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`; адказ на практыкаванне застаецца запісам, які належыць прыкладанню.
Запіс → Спыніць → Play preview. Дайце навучэнцу перамотваць, запавольваць папярэдні прагляд або адмяняць і запісваць іншую спробу. Save locally толькі калі яны вырашаюць захаваць чарнавік.
`duration`, `local_uri`, `mime_type` і `draft_id` апісваюць спробу. Вашае прыкладанне вырашае, ці застаецца яно лакальным, ці пазней будзе адпраўлена праз абраны працэс загрузкі.
Пры `preview_error` захоўвайце чарнавік і паказвайце `error_code`. Не ператварайце папярэдні прагляд або захаваны чарнавік у адпраўлены адказ, пакуль працэс адпраўкі ў прыкладанні не завершыцца паспяхова.
Загрузка Bubble стварае публічны аўдыёфайл. Не выкарыстоўвайце гэтую загрузку для канфідэнцыяльных запісаў.
Захоўвайце лакальны галасавы чарнавік і зрабіце кнопку «Адправіць» яўнай
Выязны супрацоўнік можа быць перапынены, не скончыўшы нататку, і не павінен загружаць яе толькі каб захаваць яе.
`saved_draft_id = the draft ID stored by your app for this device and account`; `title = the selected non-sensitive task label`.
Пачаць/Stop recording → Save locally. Захавайце вернуты `draft_id` у вашым уласным станe, звязаным з прыладай/акаўнтам. Выкарыстоўвайце 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.
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.
Звязаныя кіраўніцтва
Для дапамогі паведаміце, які плагін і прыладу вы выкарыстоўваеце, якую дзею спрабавалі і што адбылося. Выкарыстоўвайце прыклад без асабістых даных. Ніколі не дзяліцеся вашым ключом або прыватнымі файламі.