Xodera Plugins · Bubble Native
Xodera Offline Files Native
Saglabājiet ziņojuma pielikumus un izvēlētos failus ierīcē, atjaunojiet tos vēlāk un ļaujiet lietotājam koplietot izvēlēto kopiju.
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.
Dokumentācija pārskatīta 6 novembrī 2026
Praktiski piemēri
Sagatavojiet vairākus lokālus pielikumus pirms ziņojuma iesniegšanas
Forma jāparāda, kuri faili tika izvēlēti, un jāļauj lietotājam saglabāt pārvaldītu kopiju pirms jebkādas mākoņa iesniegšanas.
`accepted_mime_types_json = your allowed MIME list`; `multiple = yes`; iestatiet `max_files`, `max_file_bytes` un konta/ziņojuma `document_context`.
Pick files → pārbaudiet izvēlētos nosaukumus/izmērus → Save selection locally. Jūsu forma saglabā rezultējošos failu ID, līdz atsevišķa Iesniegt darbplūsma augšupielādē apstiprinātos failus.
Izmantojiet `selection_count`, `file_names`, `file_sizes` un `saved_file_ids`, lai attēlotu pārskatu sarakstu. Saglabāta pārvaldīta kopija saglabā izsaucēja oriģinālu.
Atcelts izvēlētājs nav iesniegts ziņojums. Uz `files_error` saglabājiet jau pieņemtos lokālos ID un parādiet `error_code`; nekad neveidojiet mākoņa pielikumu tikai no lokālā URI.
Faili paliek šajā ierīcē, līdz tie tiek koplietoti vai augšupielādēti atsevišķi.
Saglabājiet foto redaktora vai ierakstītāja izvadi turpmākai lietošanai
Ģenerēts lokālais fails var atrasties pagaidu vietā; lietotnei ir nepieciešama skaidri pārvaldīta kopija.
`source_uri = the local output of a separately accepted editor/recorder`; saistiet tā īsto `display_name` un `mime_type`; izmantojiet tā paša īpašnieka `document_context`.
Load local source → pārbaudiet metadatus → Save selection locally. Saglabājiet atgriezto faila ID tikai atbilstošajā ierīcē/kontekstā, pēc tam Restore saved file ar šo precīzo ID, kad tas nepieciešams.
Izmantojiet `file_id`, `local_uri`, `size_bytes` un `is_saved_locally`; izmantojiet `file_restored`, lai atšķirtu pabeigtu atjaunošanu no tikai pieprasījuma.
Noraidiet attālināto HTTP URL kā lokālu avotu. Ja avots pazūd vai atjaunošana neizdodas, parādiet `error_code` un saglabājiet sākotnējo lietotnes ierakstu atgūšanai.
Faili paliek šajā ierīcē, līdz tie tiek koplietoti vai augšupielādēti atsevišķi.
Ļaujiet lietotājam koplietot lietotnes ģenerētu lokālu kvīti vai eksportu
Lietotnei vajadzētu nodot izvēlēto lokālo failu ierīces koplietošanas lapai, nevis izdomāt publisku URL.
`selected_file_id = the exact managed copy chosen from your app’s saved-file list`; tā nosaukums un MIME apraksta īsto lokālo failu.
List saved files → Restore saved file → Share selected file pēc tam, kad lietotājs piespiež Koplietot. Saglabājiet saglabāto kopiju, līdz viņi skaidri izvēlas Delete saved copy.
Izmantojiet `share_status` un `share_sheet_closed`, lai atjauninātu UI pēc lapas aizvēršanas. Saglabājiet faila ID vēlai apzinātai kopīgošanai.
Aizvērta koplietošanas lapa nav pierādījums, ka e-pasts/ziņa ir piegādāta. Apstrādājiet atcelšanu un `files_error`, neziņojot par veiksmi saņēmējam.
Faili paliek šajā ierīcē, līdz tie tiek koplietoti vai augšupielādēti atsevišķi.
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.
Iestatiet document_context = Current User's unique id vai stabilu vērtību kontam un ziņojumam. Izvēlieties accepted_mime_types_json, max_files un max_file_bytes.
Izpildiet Pick files vai izmantojiet Load local source, lai iegūtu lasāmu failu, ko izveidoja Foto redaktors vai Ierakstītājs. Pēc selection_changed izlasiet atbilstošos failu sarakstus; Select picked file izvēlas indeksu.
Izpildiet Save selection locally. Pēc files_saved saglabājiet saved_file_ids savas lietotnes lokālajā pielikumu ierakstā. List saved files parāda saglabātās kopijas; Restore saved file atver izvēlēto saglabāto ID.
Share selected file atver sistēmas koplietošanas izvēlni. share_sheet_closed tikai nozīmē, ka izvēlne aizvērās. Delete saved copy vajag izvēlēto ID un confirm=yes.
Konfigurējiet vienreiz
Izveidojiet vai izvēlieties savu Bubble lietotnes projektu vietnē BestPlugins → Dashboard → Plugins. Izvēlieties Xodera Offline Files Native, nokopējiet tā atslēgu, pēc tam atveriet Bubble → Plugins → Xodera Offline Files 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 vietējo lietotni ar piekļuvi izvēlētajiem failiem. Kontam vai pārskatam iestatiet stabilu document_context, lai tā saglabātie faili būtu pareizi sagrupēti.
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 LocalAttachment: īpašnieks, document_context, saglabātā faila ID, display_name, mime_type un size_bytes. Šis ID darbojas tikai tajā pašā ierīcē un tajā pašā kontā vai ziņojumā. Lai pievienotu tiešsaistes pielikumu, augšupielādējiet failu atsevišķā darbplūsmā un saglabājiet atgriezto tiešsaistes faila atsauci.
Kļūda, atcelšana un atjaunošana
Atcelts izvēlētājs atgriež operation_cancelled; tas neiesniedz formu. Kamēr native_pending=yes, pagaidiet, līdz failu izvēlētājs vai koplietošanas izvēlne aizvēršas, pirms atverat citu. Clear session notīra pašreizējo izvēli, bet saglabā saglabātās kopijas. Ja fails trūkst, ļaujiet lietotājam to izvēlēties vēlreiz.
Iespējas un ierobežojumi
Izvēlieties 1–20 failus vienlaicīgi. Viena faila limits: 1 baiti–256 MiB, ar zemāku limitu, ja izvēlaties. Failu tipa filtri nepārbauda failus pret vīrusiem. Ierīces failu ID un ceļi nedarbojas kā mākoņa lejupielādes saites. Lokālās kopijas nav šifrētas un var tikt zaudētas, ja tiek noņemti lietotnes dati.
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_uri · textdisplay_name · textmime_type · textdocument_context · textselected_file_id · textaccepted_mime_types_json · textmultiple · yes_nocopy_to_cache · yes_nomax_files · numbermax_file_bytes · numberis_active · yes_nodisabled · yes_noshow_controls · yes_nolanguage · textui_text_json · texttitle · textStāvokļi
status · textis_busy · yes_nonative_pending · yes_nooperation · textselection_count · numberselected_index · numberfile_id · textlocal_uri · textdisplay_name · textmime_type · textmime_source · textsize_bytes · numberis_saved_locally · yes_nofile_ids · text (saraksts)file_uris · text (saraksts)file_names · text (saraksts)file_mime_types · text (saraksts)file_sizes · number (saraksts)files_json · textsaved_count · numbersaved_file_ids · text (saraksts)saved_file_uris · text (saraksts)saved_file_names · text (saraksts)saved_file_mime_types · text (saraksts)saved_file_sizes · number (saraksts)saved_files_json · textinvalid_saved_count · numbershare_status · texterror_code · textNotikumi
selection_changedfiles_savedlist_loadedfile_restoredfile_deletedshare_sheet_closedoperation_cancelledfiles_errorDarbības un to ievades
Pick filesLoad local sourceSelect picked fileSave selection locallyList saved filesRestore saved fileDelete saved copyShare selected fileCancel operationClear sessionElementa iestatījumi · 16
source_uritext · Noklusējums: ""- Piemēra vērtība
file:///app-cache/report.pdf - Piemērs Bubble izteiksmei
Photo Editor's output_uri - Lasāma faila atrašanās vieta šajā ierīcē, ko atgriež jūsu izvēlētājs vai kāds cits spraudnis.
display_nametext · Noklusējums: ""- Piemēra vērtība
report-photo.jpg - Piemērs Bubble izteiksmei
Selected Attachment's display_name - Izmantojiet pašreizējā biznesa ieraksta vērtību; pārbaudiet to pret zemāk norādītajiem ierobežojumiem.
mime_typetext · Noklusējums: ""- Piemēra vērtība
image/jpeg - Piemērs Bubble izteiksmei
Photo Editor's output_mime - Izmantojiet pašreizējā biznesa ieraksta vērtību; pārbaudiet to pret zemāk norādītajiem ierobežojumiem.
document_contexttext · Noklusējums: "default"- Piemēra vērtība
<current-user-id> - Piemērs Bubble izteiksmei
Current User's unique id - Stabila vērtība šim kontam vai ierakstam. Izmantojiet to pašu vērtību, atjaunojot saglabātos failus vai melnrakstus.
selected_file_idtext · Noklusējums: ""- Piemēra vērtība
<returned saved file ID> - Piemērs Bubble izteiksmei
Selected LocalAttachment's local_file_id - Izmantojiet pašreizējā biznesa ieraksta vērtību; pārbaudiet to pret zemāk norādītajiem ierobežojumiem.
accepted_mime_types_jsontext · Noklusējums: "[\"*/*\"]"- Piemēra vērtība
["image/*","application/pdf"] - Piemērs Bubble izteiksmei
Report Settings' accepted_mime_types_json - Izmantojiet pašreizējā biznesa ieraksta vērtību; pārbaudiet to pret zemāk norādītajiem ierobežojumiem.
multipleyes_no · Noklusējums: false- Piemēra vērtība
yes - Piemērs Bubble izteiksmei
Report Settings' allow_multiple_attachments - Izmantojiet pašreizējā biznesa ieraksta vērtību; pārbaudiet to pret zemāk norādītajiem ierobežojumiem.
copy_to_cacheyes_no · Noklusējums: true- Piemēra vērtība
yes - Piemērs Bubble izteiksmei
Report Settings' copy_to_cache - Izmantojiet pašreizējā biznesa ieraksta vērtību; pārbaudiet to pret zemāk norādītajiem ierobežojumiem.
max_filesnumber · Noklusējums: 20- Piemēra vērtība
5 - Piemērs Bubble izteiksmei
Report Settings' attachment_limit - Izmantojiet pašreizējā biznesa ieraksta vērtību; pārbaudiet to pret zemāk norādītajiem ierobežojumiem.
max_file_bytesnumber · Noklusējums: 268435456- Piemēra vērtība
10485760 - Piemērs Bubble izteiksmei
Report Settings' max_attachment_bytes - 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ība
yes - Piemērs Bubble izteiksmei
GuideHost'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ība
no - Piemērs Bubble izteiksmei
GuideHost's is_busy (your yes/no custom state) - Atspējojiet elementu, kamēr jūsu lietotne ir aizņemta vai šī darbība nav pieejama.
show_controlsyes_no · Noklusējums: true- Piemēra vērtība
yes - Piemērs Bubble izteiksmei
App Settings' show_editor_controls - Rādīt vai paslēpt iebūvētos vadīklus.
languagetext · Noklusējums: "auto"- Piemēra vērtība
uk - Piemērs Bubble izteiksmei
Current 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.
ui_text_jsontext · Noklusējums: ""- Piemēra vērtība
{} - Piemērs Bubble izteiksmei
App 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.
titletext · Noklusējums: ""- Piemēra vērtība
Lesson 4 — review - Piemērs Bubble izteiksmei
Selected Lesson's name - Redzams lietotnes teksts; tukšs lieto iebūvēto lokalizēto tekstu, ja tas ir atbalstīts. Nav akreditācijas dati.
Darbības un to ievades · 10
Pick files
Nav darbības parametru
Load local source
source_uritext · Noklusējums: —- Piemēra vērtība
file:///app-cache/report.pdf - Piemērs Bubble izteiksmei
Photo Editor's output_uri - Lasāma faila atrašanās vieta šajā ierīcē, ko atgriež jūsu izvēlētājs vai kāds cits spraudnis.
display_nametext · Noklusējums: —- Piemēra vērtība
report-photo.jpg - Piemērs Bubble izteiksmei
Selected Attachment's display_name - Izmantojiet pašreizējā biznesa ieraksta vērtību; pārbaudiet to pret zemāk norādītajiem ierobežojumiem.
mime_typetext · Noklusējums: —- Piemēra vērtība
image/jpeg - Piemērs Bubble izteiksmei
Photo Editor's output_mime - Izmantojiet pašreizējā biznesa ieraksta vērtību; pārbaudiet to pret zemāk norādītajiem ierobežojumiem.
Select picked file
indexnumber · Noklusējums: —- Piemēra vērtība
0 - Piemērs Bubble izteiksmei
Selected row's current_source_index - Izmantojiet pašreizējā biznesa ieraksta vērtību; pārbaudiet to pret zemāk norādītajiem ierobežojumiem.
Save selection locally
Nav darbības parametru
List saved files
Nav darbības parametru
Restore saved file
file_idtext · Noklusējums: —- Piemēra vērtība
<returned saved file ID> - Piemērs Bubble izteiksmei
Selected LocalAttachment's local_file_id - Izmantojiet pašreizējā biznesa ieraksta vērtību; pārbaudiet to pret zemāk norādītajiem ierobežojumiem.
Delete saved copy
file_idtext · Noklusējums: —- Piemēra vērtība
<returned saved file ID> - Piemērs Bubble izteiksmei
Selected LocalAttachment's local_file_id - Izmantojiet pašreizējā biznesa ieraksta vērtību; pārbaudiet to pret zemāk norādītajiem ierobežojumiem.
confirmyes_no · Noklusējums: —- Piemēra vērtība
yes — explicit confirmation only - Piemērs Bubble izteiksmei
Confirm Checkbox is checked - Izmantojiet pašreizējā biznesa ieraksta vērtību; pārbaudiet to pret zemāk norādītajiem ierobežojumiem.
Share selected file
dialog_titletext · Noklusējums: —- Piemēra vērtība
Share attachment - Piemērs Bubble izteiksmei
Selected Report's share_title - Izmantojiet pašreizējā biznesa ieraksta vērtību; pārbaudiet to pret zemāk norādītajiem ierobežojumiem.
utitext · Noklusējums: —- Piemēra vērtība
"" - Piemērs Bubble izteiksmei
Empty unless your iOS integration supplies a proven UTI - Izmantojiet pašreizējā biznesa ieraksta vērtību; pārbaudiet to pret zemāk norādītajiem ierobežojumiem.
Cancel operation
Nav darbības parametru
Clear session
Nav darbības parametru
Stāvokļi un notikumi
Stāvokļi
status · textPašreizējais šīs darbības rezultāts. Izmantojiet atbilstošo pabeigšanas notikumu pirms saglabājat veiksmi.
is_busy · yes_noDarbs joprojām notiek. Pagaidiet, pirms uzsākt citu darbību.
native_pending · yes_noDarbs joprojām notiek. Pagaidiet, pirms uzsākt citu darbību.
operation · textPašreizējā izvēlētā vienuma vērtība. Nolasiet to pēc saistītā notikuma.
selection_count · numberPašreizējā izvēlētā vienuma vērtība. Nolasiet to pēc saistītā notikuma.
selected_index · numberPašreizējā izvēlētā vienuma vērtība. Nolasiet to pēc saistītā notikuma.
file_id · textIdentifikators šim vienumam vai darbībai. Saglabājiet to kopā ar atbilstošu lietotnes ierakstu. Izmantojiet to pašu pieprasījuma identifikatoru, atkārtotot nenoteiktu rezultātu.
local_uri · textFaila atrašanās vieta šajā ierīcē. Saglabājiet vai augšupielādējiet failu atsevišķi, ja tas jāuzglabā tiešsaistē.
display_name · textPašreizējā izvēlētā vienuma vērtība. Nolasiet to pēc saistītā notikuma.
mime_type · textPašreizējā izvēlētā vienuma vērtība. Nolasiet to pēc saistītā notikuma.
mime_source · textPašreizējā izvēlētā vienuma vērtība. Nolasiet to pēc saistītā notikuma.
size_bytes · numberPašreizējā izvēlētā vienuma vērtība. Nolasiet to pēc saistītā notikuma.
is_saved_locally · yes_noPašreizējā izvēlētā vienuma vērtība. Nolasiet to pēc saistītā notikuma.
file_ids · text (saraksts)Saraksts izvēlētajiem failiem. Vienumi ar tādu pašu indeksu citos failu sarakstos attiecas uz to pašu failu.
file_uris · text (saraksts)Saraksts izvēlētajiem failiem. Vienumi ar tādu pašu indeksu citos failu sarakstos attiecas uz to pašu failu.
file_names · text (saraksts)Saraksts izvēlētajiem failiem. Vienumi ar tādu pašu indeksu citos failu sarakstos attiecas uz to pašu failu.
file_mime_types · text (saraksts)Saraksts izvēlētajiem failiem. Vienumi ar tādu pašu indeksu citos failu sarakstos attiecas uz to pašu failu.
file_sizes · number (saraksts)Saraksts izvēlētajiem failiem. Vienumi ar tādu pašu indeksu citos failu sarakstos attiecas uz to pašu failu.
files_json · textPašreizējā izvēlētā vienuma vērtība. Nolasiet to pēc saistītā notikuma.
saved_count · numberPašreizējā izvēlētā vienuma vērtība. Nolasiet to pēc saistītā notikuma.
saved_file_ids · text (saraksts)Saraksts izvēlētajiem failiem. Vienumi ar tādu pašu indeksu citos failu sarakstos attiecas uz to pašu failu.
saved_file_uris · text (saraksts)Saraksts izvēlētajiem failiem. Vienumi ar tādu pašu indeksu citos failu sarakstos attiecas uz to pašu failu.
saved_file_names · text (saraksts)Saraksts izvēlētajiem failiem. Vienumi ar tādu pašu indeksu citos failu sarakstos attiecas uz to pašu failu.
saved_file_mime_types · text (saraksts)Saraksts izvēlētajiem failiem. Vienumi ar tādu pašu indeksu citos failu sarakstos attiecas uz to pašu failu.
saved_file_sizes · number (saraksts)Saraksts izvēlētajiem failiem. Vienumi ar tādu pašu indeksu citos failu sarakstos attiecas uz to pašu failu.
saved_files_json · textPašreizējā izvēlētā vienuma vērtība. Nolasiet to pēc saistītā notikuma.
invalid_saved_count · numberPašreizējā izvēlētā vienuma vērtība. Nolasiet to pēc saistītā notikuma.
share_status · textPašreizējais šīs darbības rezultāts. Izmantojiet atbilstošo pabeigšanas notikumu pirms saglabājat veiksmi.
error_code · textKļūdas informācija par pēdējo darbību. Rādiet noderīgu ziņojumu un piedāvājiet atbilstošu atkārtotu mēģinājumu.
Notikumi
selection_changedKad šis notikums notiek, nolasiet saistītās stāvokļus no tā paša elementa.
files_savedKad šis notikums notiek, nolasiet saistītās stāvokļus no tā paša elementa.
list_loadedKad šis notikums notiek, nolasiet saistītās stāvokļus no tā paša elementa.
file_restoredKad šis notikums notiek, nolasiet saistītās stāvokļus no tā paša elementa.
file_deletedKad šis notikums notiek, nolasiet saistītās stāvokļus no tā paša elementa.
share_sheet_closedKad šis notikums notiek, nolasiet saistītās stāvokļus no tā paša elementa.
operation_cancelledKad šis notikums notiek, nolasiet saistītās stāvokļus no tā paša elementa.
files_errorKad šis notikums notiek, nolasiet saistītās stāvokļus no tā paša elementa.
Izstrādātāju uzdotie jautājumi
Vai Koplietošana nozīmē “nosūtīts”?
Nē. OS šeit nenodrošina uzticamu saņēmēja veiksmīgu saņemšanas apstiprinājumu. Parādiet “koplietošanas izvēlne aizvērta”.
Kā darbojas 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.
Saistītie ceļveži
Palīdzībai, informējiet mūs, kuru spraudni un ierīci izmantojat, kādu darbību mēģinājāt veikt un kas notika. Izmantojiet piemēru bez personas datiem. Nekad neizpaudiet savu atslēgu vai privātos failus.