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 жүктеуі қоғамдық аудио файл жасайды. Бұл жүктеуді құпия жазбалар үшін пайдаланбаңыз.
Жергілікті дауыс нобайын сақтап, 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` мәнін өз қолданбаңыздың тиісті құрылғы мен тіркелгіге байланған күйінде сақтаңыз. Сол ID үшін Restore local draft пайдаланыңыз, содан кейін жүктеп салу туралы шешім қабылдамас бұрын 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) - Бұл көрініс ашық кезде 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. Кіріктірілген мәтінді пайдалану үшін бос қалдырыңыз.
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 қолданба файл-жүктеу мекенжайы: Development үшін /version-test/fileupload, Live үшін /fileupload. Бұл жүктеп салу жалпыға қолжетімді файлдарды жасайды.
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 · fileupload_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.
Қатысты нұсқаулықтар
Көмек алу үшін, қандай плагин мен құрылғыны пайдаланатыныңызды, қандай әрекетті орындағаныңызды және не болғанын айтыңыз. Жеке деректерсіз мысал қолданыңыз. Кілтіңізді немесе жеке файлдарыңызды ешқашан бөліспеңіз.