Xodera Plugins · Bubble Native

Xodera B2 Files Native

앱 첨부 파일을 자체 Backblaze B2 저장소에 보관하십시오. 허가된 사용자가 파일을 업로드, 탐색 및 다운로드하도록 허용하고, 파일을 공개적으로 공유할 수 있는 시점을 명시적으로 선택하십시오.

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.

워크플로우 만들기 ↓플러그인 설정 ↗Native Lab

문서 검토일: 2026년 11월 6일

실용적인 예시

개발자의 개인 버킷에 작업 첨부 파일을 저장하십시오.

Bubble Job 레코드에는 영구적인 저장소 참조가 필요합니다. 만료되는 다운로드 URL을 파일 식별자로 취급해서는 안 됩니다.

`bucket_binding_id = an allowed binding to your own private bucket`; 동적 `local_uri`, `display_name`, `mime_type` 및 `expected_size`가 선택된 로컬 파일을 설명합니다.

예정: Check local source → Upload file → `upload_verified` 대기. 그런 다음 워크플로가 `asset_ref`와 메타데이터를 소유한 Job 레코드에 저장합니다.

`asset_ref`, `size_bytes`, `mime_type` 및 `upload_status`를 사용합니다. 이후 Resolve private read는 권한 있는 사용을 위한 임시 URL을 제공할 수 있습니다.

`upload_verified` 후 데이터베이스 저장이 실패하면 다른 업로드가 아니라 동일한 자산 참조로 DB 업데이트를 재시도하십시오. `upload_pending`의 결과를 Check or recover upload status와 동일한 업로드 ID를 사용해 확인합니다.

예정. 귀하의 B2 계정이 저장 및 다운로드 비용을 지불합니다.

내구성 있는 파일 레코드로 소유된 첨부 갤러리를 구축합니다

파일 갤러리에는 이름, 유형, 페이지네이션이 필요하며 선택된 자산을 나중에 열 수 있는 방법도 필요합니다.

앱의 File 레코드는 검증된 업로드 후 승인된 `asset_ref`, 표시 이름, MIME 및 소유자와 Job의 관계를 저장합니다. 로컬 URI를 클라우드 식별자로 사용하지 마세요.

예정: List my B2 files를 사용해 첨부 목록을 구축합니다. asset_refs가 파일을 식별합니다; 동일 인덱스의 값이 이름과 유형을 제공합니다. 파일을 선택하면 해당 asset_ref가 Get asset metadata 또는 Download accepted version에 전달됩니다.

`has_more`와 `next_cursor`는 현재 쿼리에 속합니다. 완료된 다운로드는 `local_output_uri`를 반환합니다; 이는 장치 로컬 복사본이며 영구적인 공개 링크가 아닙니다.

바인딩, 계정 또는 쿼리가 변경되면 페이지네이션을 초기화하세요. `transfer_error`에서는 기존 File Thing을 보존하고 `error_code`를 표시하세요. 다른 제공자 버전으로 알리지 않고 교체하지 마세요.

예정. 귀하의 B2 계정이 저장 및 다운로드 비용을 지불합니다.

게시 및 정확한 버전 삭제를 의도적으로 수행합니다

직원은 이미지를 교체할 때 실수로 개인 첨부 파일을 노출하거나 모든 버전을 삭제해서는 안 됩니다.

`asset_ref = the selected accepted version`; 버킷 바인딩 및 앱의 파일 권한은 요청된 작업을 허용해야 합니다.

현재 가시성을 표시하고 명시적인 확인을 요청한 뒤 Change public sharing를 수행합니다. 제거의 경우 확인과 함께 Delete accepted version를 호출하십시오; 확인된 결과가 알려질 때까지 앱 메타데이터를 유지합니다.

`share_changed` 후, 공개 공유가 명시적으로 허가된 경우에만 `visibility`와 `public_url`를 사용합니다. `delete_completed` 후, 소유된 파일 레코드를 업데이트합니다; `delete_pending`는 최종 삭제가 아닙니다.

성공을 가정하지 말고 불확실한 작업의 결과를 확인하십시오. 이전에 발행된 제공자 읽기 URL은 만료될 때까지 유효할 수 있으며, DB 행을 삭제하거나 공유를 비활성화해도 이미 다운로드된 바이트는 회수되지 않습니다.

예정. 귀하의 B2 계정이 저장 및 다운로드 비용을 지불합니다.

현재 작동 중인 항목

예정된 플러그인입니다. 아직 설치되지 않았으며 사용할 수 없습니다. 아래 가이드는 의도된 파일 워크플로를 보여줍니다.

워크플로우 만들기

예정

예정된 워크플로우. 현재 베타에서는 아직 사용할 수 없습니다.

이 예제들은 Lesson, Message 및 Order와 같은 앱 레코드를 사용합니다. 이를 귀하의 데이터 유형 및 요소 이름으로 교체하십시오. 예시 미디어 주소는 귀하의 파일로 교체해야 합니다.

예정: 프로젝트 설정에서 B2 저장소와 허용 버킷을 선택하십시오. 프라이버시, 폴더 접두사 및 허용 파일 유형과 크기를 설정하십시오.
허용된 저장소 선택지를 표시하려면 List B2 bindings를 사용하십시오. 현재 사용자의 파일을 표시하려면 List my B2 files를, 상세 정보를 보려면 Get my B2 file info를 사용하십시오.
파일을 선택하십시오. bucket_binding_id, local_uri, display_name, mime_type 및 expected_size를 설정한 후 Upload file를 실행하십시오. 진행 상황을 표시하되, 파일을 저장된 것으로 간주하기 전에 upload_verified를 기다리십시오.
앱 레코드에 asset_ref를 저장하십시오. 이를 Get asset metadata, Resolve private read 또는 Download accepted version에 사용하십시오. Change public sharing와 Delete accepted version는 별도의 확인이 필요합니다.

워크플로우 다이어그램 — 앱 스크린샷이 아님

한 번만 설정

이 플러그인에 대한 키 활성화는 예정되어 있습니다. BestPlugins → Dashboard → Plugins에서 Bubble 앱 프로젝트를 만들거나 선택하세요. Xodera B2 Files Native를 선택하고 키를 복사한 뒤 Bubble → Plugins → Xodera B2 Files Native를 열어 project_api_key에 붙여넣으세요. 한 번 저장한 후 아래 작업을 사용하세요. 각 프로젝트의 각 플러그인마다 고유한 키가 있습니다.

자신의 Backblaze B2 계정을 사용하고 이 앱의 버킷을 선택하세요. 파일을 읽고 업로드할 수 있는 사용자를 정하세요. User의 관련 yes/no 필드 이름을 b2_reader_permission_field와 b2_writer_permission_field에 저장하세요. 기본값은 b2_files_reader와 b2_files_writer입니다. 권한이 있는 관리자만 이 사용자 권한을 변경해야 합니다.

한 번만 설정

BestPlugins → Dashboard → Plugins에서 Bubble 앱 프로젝트를 만들거나 선택하십시오.
이 플러그인을 선택하고 프로젝트 키를 복사하십시오.
예정: Bubble → Plugins → Xodera B2 Files Native를 열고, 키를 project_api_key에 붙여넣은 뒤 저장하세요.
요소를 추가하고 앱 데이터를 선택한 뒤 아래 워크플로우를 구축하십시오.
현재는 비공개 베타 접근만 가능합니다. 공개 설치 및 유료 활성화는 아직 열려 있지 않습니다.

설치 및 구독

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.

결과를 앱에 저장

예시 첨부 파일: asset_ref, 관련 보고서/주문, 소유자, display_name, mime_type 및 size_bytes. upload_verified 이후에 이를 저장하십시오. 나중에 파일을 다시 열려면 asset_ref를 사용하십시오; 임시 읽기 주소나 한 장치의 경로는 영구적인 파일 참조가 아닙니다. 데이터베이스 레코드 저장에 실패하면 파일을 다시 업로드하지 말고 해당 레코드 저장을 재시도하십시오.

실패, 취소 및 복구

업로드 결과가 알 수 없는 경우 upload_id를 유지하고 Check or recover upload status를 사용하십시오. 자동으로 다른 복사본을 업로드하지 마십시오. 취소는 미완료 전송에만 영향을 미치며 이미 저장된 파일에는 영향을 주지 않습니다. 접근 권한이 만료되면 오래된 임시 주소를 재사용하지 말고 파일을 다시 요청하십시오.

기능 및 제한

예정된 최대 파일 크기: 256 MiB, 또는 선택한 더 낮은 버킷 제한. Backblaze 저장 및 다운로드 비용은 귀하의 B2 계정에 귀속됩니다. 공개 버킷의 파일은 관련 앱 레코드가 비공개일 때도 공개됩니다. 바이러스 스캔 보증, 다중 파트 업로드, 일시 중지 또는 앱 종료 후 복구는 제공되지 않습니다.

설정, 액션 및 결과

Bubble에서 이러한 이름을 사용하세요. 예정 기능은 별도로 표시됩니다.

사용 가능한 베타 설정

요소 설정

bucket_binding_id · textlocal_uri · textdisplay_name · textmime_type · textexpected_size · numbermetadata_json · textasset_ref · textis_active · yes_nodisabled · yes_nolanguage · textui_text_json · texttitle · textshow_preview · yes_noshow_provider_browse · yes_no

상태

status · textis_busy · yes_noupload_id · textupload_status · textasset_ref · textdisplay_name · textmime_type · textsize_bytes · numberbytes_sent · numberprogress · numberprogress_indeterminate · yes_notemporary_read_url · textread_expires_at · textlocal_output_uri · textpublic_url · textvisibility · textnext_cursor · texthas_more · yes_noquery_revision · textfiles_json · textbuckets_json · textremote_files_json · textremote_next_cursor · textremote_has_more · yes_noremote_query_revision · textbucket_binding_id · textcleanup_pending · yes_noerror_code · texterror_message · text

이벤트

file_selectedupload_startedupload_transport_completedupload_verifiedupload_pendingbuckets_loadedbucket_selectedlist_loadedmetadata_loadedread_resolveddownload_completedshare_changeddelete_completeddelete_pendingbrowse_loadedtransfer_cancelledcleanup_pendingtransfer_errorsession_cleared

액션 및 입력값

List allowed bucketsSelect bucket bindingCheck local sourceUpload fileCheck or recover upload statusCancel owned transferClear local sessionList application filesRefresh application filesLoad more application filesSelect asset referenceGet asset metadataResolve private readDownload accepted versionBrowse provider filesChange public sharingDelete accepted version

요소 설정 · 14

예정된 워크플로우. 현재 베타에서는 아직 사용할 수 없습니다.

bucket_binding_idtext · 기본값: "": 예시 값<binding returned by List B2 bindings>; 예시 Bubble 표현Selected Binding's binding_id; List B2 bindings가 반환한 저장소 선택입니다. 이 파일에 해당 ID를 사용하십시오.

local_uritext · 기본값: "": 예시 값file:///app-cache/attachment.jpg; 예시 Bubble 표현Offline Files' local_uri; 이 장치의 읽을 수 있는 파일 위치입니다. 온라인 다운로드 링크가 아닙니다.

display_nametext · 기본값: "": 예시 값report-photo.jpg; 예시 Bubble 표현Selected Attachment's display_name; 현재 비즈니스 레코드의 값을 사용하고, 아래 제한과 비교해 검증하십시오.

mime_typetext · 기본값: "": 예시 값image/jpeg; 예시 Bubble 표현Photo Editor's output_mime; 현재 비즈니스 레코드의 값을 사용하고, 아래 제한과 비교해 검증하십시오.

expected_sizenumber · 기본값: 0: 예시 값246975; 예시 Bubble 표현Offline Files' size_bytes; 현재 비즈니스 레코드의 값을 사용하고, 아래 제한과 비교해 검증하십시오.

metadata_jsontext · 기본값: "": 예시 값{"label":"field-report"}; 예시 Bubble 표현Selected Attachment's safe_metadata_json; 옵션 JSON(보고서 레이블 등)와 앱 정보. 작게 유지하고 개인 데이터를 피하십시오.

asset_reftext · 기본값: "": 예시 값<returned asset_ref>; 예시 Bubble 표현Selected B2Asset's asset_ref; 서비스에서 제공하는 안정적인 불투명 수락 자산 ID. 선택해도 사용자 권한을 우회하지 않습니다.

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); 앱이 바쁘거나 이 작업을 사용할 수 없을 때 요소를 비활성화합니다.

languagetext · 기본값: "auto": 예시 값uk; 예시 Bubble 표현Current User's preferred_language; language=auto로 설정하면 기기 또는 브라우저의 언어가 지원되는 경우 해당 언어를 따릅니다. 특정 언어를 직접 선택하려면 지원되는 언어 코드를 입력하세요.

ui_text_jsontext · 기본값: "": 예시 값{}; 예시 Bubble 표현App Settings' player_labels_json (supported keys only); 지원되는 버튼 레이블이 포함된 선택적 JSON. 비워 두면 내장 텍스트를 사용합니다.

titletext · 기본값: "": 예시 값Lesson 4 — review; 예시 Bubble 표현Selected Lesson's name; 보이는 앱 텍스트; 비워 두면 지원되는 경우 내장된 현지화된 복사본을 사용합니다. 자격 증명 없음.

show_previewyes_no · 기본값: false: 예시 값yes; 예시 Bubble 표현App Settings' b2_preview; 파일 미리보기를 표시하거나 숨깁니다.

show_provider_browseyes_no · 기본값: false: 예시 값no; 예시 Bubble 표현Current User's authorized_browse_UI (presentation only); 허가된 사용자를 위한 저장소 탐색 컨트롤을 표시하거나 숨깁니다.

액션 및 입력값 · 20

예정된 워크플로우. 현재 베타에서는 아직 사용할 수 없습니다.

List allowed buckets

동작 매개변수 없음

Select bucket binding

binding_idtext · 기본값: —: 예시 값<returned allowed binding ID>; 예시 Bubble 표현Selected Binding's binding_id; 현재 비즈니스 레코드의 값을 사용하고, 아래 제한과 비교해 검증하십시오.

Check local source

동작 매개변수 없음

Upload file

acknowledge_public_bytesyes_no · 기본값: —: 예시 값no; 예시 Bubble 표현Public bucket disclosure Checkbox is checked (private bucket: no); 현재 비즈니스 레코드의 값을 사용하고, 아래 제한과 비교해 검증하십시오.

confirm_retryyes_no · 기본값: —: 예시 값no; 예시 Bubble 표현Retry Checkbox is checked after confirmed clean pending status; 현재 비즈니스 레코드의 값을 사용하고, 아래 제한과 비교해 검증하십시오.

Check or recover upload status

upload_idtext · 기본값: —: 예시 값<original returned upload_id>; 예시 Bubble 표현Current UploadIntent's upload_id; 현재 비즈니스 레코드의 값을 사용하고, 아래 제한과 비교해 검증하십시오.

Cancel owned transfer

동작 매개변수 없음

Clear local session

동작 매개변수 없음

List application files

동작 매개변수 없음

Refresh application files

동작 매개변수 없음

Load more application files

동작 매개변수 없음

Select asset reference

asset_reftext · 기본값: —: 예시 값<returned asset_ref>; 예시 Bubble 표현Selected B2Asset's asset_ref; 서비스에서 제공하는 안정적인 불투명 수락 자산 ID. 선택해도 사용자 권한을 우회하지 않습니다.

Get asset metadata

asset_reftext · 기본값: —: 예시 값<returned asset_ref>; 예시 Bubble 표현Selected B2Asset's asset_ref; 서비스에서 제공하는 안정적인 불투명 수락 자산 ID. 선택해도 사용자 권한을 우회하지 않습니다.

Resolve private read

asset_reftext · 기본값: —: 예시 값<returned asset_ref>; 예시 Bubble 표현Selected B2Asset's asset_ref; 서비스에서 제공하는 안정적인 불투명 수락 자산 ID. 선택해도 사용자 권한을 우회하지 않습니다.

Download accepted version

asset_reftext · 기본값: —: 예시 값<returned asset_ref>; 예시 Bubble 표현Selected B2Asset's asset_ref; 서비스에서 제공하는 안정적인 불투명 수락 자산 ID. 선택해도 사용자 권한을 우회하지 않습니다.

Browse provider files

prefixtext · 기본값: —: 예시 값""; 예시 Bubble 표현Authorized Browse Settings' prefix; 현재 비즈니스 레코드의 값을 사용하고, 아래 제한과 비교해 검증하십시오.

load_moreyes_no · 기본값: —: 예시 값no; 예시 Bubble 표현Load More button only, for unchanged query; 현재 비즈니스 레코드의 값을 사용하고, 아래 제한과 비교해 검증하십시오.

Change public sharing

asset_reftext · 기본값: —: 예시 값<returned asset_ref>; 예시 Bubble 표현Selected B2Asset's asset_ref; 서비스에서 제공하는 안정적인 불투명 수락 자산 ID. 선택해도 사용자 권한을 우회하지 않습니다.

enabledyes_no · 기본값: —: 예시 값no; 예시 Bubble 표현Public Share Checkbox is checked after separate confirmation; 현재 비즈니스 레코드의 값을 사용하고, 아래 제한과 비교해 검증하십시오.

confirmyes_no · 기본값: —: 예시 값yes — explicit confirmation only; 예시 Bubble 표현Confirm Checkbox is checked; 현재 비즈니스 레코드의 값을 사용하고, 아래 제한과 비교해 검증하십시오.

Delete accepted version

asset_reftext · 기본값: —: 예시 값<returned asset_ref>; 예시 Bubble 표현Selected B2Asset's asset_ref; 서비스에서 제공하는 안정적인 불투명 수락 자산 ID. 선택해도 사용자 권한을 우회하지 않습니다.

confirmyes_no · 기본값: —: 예시 값yes — explicit confirmation only; 예시 Bubble 표현Confirm Checkbox is checked; 현재 비즈니스 레코드의 값을 사용하고, 아래 제한과 비교해 검증하십시오.

List B2 bindings

environmenttext · 기본값: —: 예시 값development; 예시 Bubble 표현App Settings' selected_environment; 현재 비즈니스 레코드의 값을 사용하고, 아래 제한과 비교해 검증하십시오.

반환

ok · yes/nostatus · texterror_code · textbinding_ids · text listlabels · text listprivacy · text listmax_size_bytes · number list

List my B2 files

environmenttext · 기본값: —: 예시 값development; 예시 Bubble 표현App Settings' selected_environment; 현재 비즈니스 레코드의 값을 사용하고, 아래 제한과 비교해 검증하십시오.

binding_idtext · 기본값: —: 예시 값<returned allowed binding ID>; 예시 Bubble 표현Selected Binding's binding_id; 현재 비즈니스 레코드의 값을 사용하고, 아래 제한과 비교해 검증하십시오.

limitnumber · 기본값: —: 예시 값50; 예시 Bubble 표현Gallery Settings' page_size; 현재 비즈니스 레코드의 값을 사용하고, 아래 제한과 비교해 검증하십시오.

cursortext · 기본값: —: 예시 값""; 예시 Bubble 표현Previous List my B2 files result's next_cursor; empty on first page; 현재 비즈니스 레코드의 값을 사용하고, 아래 제한과 비교해 검증하십시오.

반환

ok · yes/nostatus · texterror_code · textasset_refs · text listdisplay_names · text listmime_types · text listsize_bytes · number listcreated_ats · text listvisibility · text listpublic_urls · text listprovider_status · text listinspection_status · text listmetadata_labels · text listhas_more · yes/nonext_cursor · textquery_revision · text

Get my B2 file info

environmenttext · 기본값: —: 예시 값development; 예시 Bubble 표현App Settings' selected_environment; 현재 비즈니스 레코드의 값을 사용하고, 아래 제한과 비교해 검증하십시오.

binding_idtext · 기본값: —: 예시 값<returned allowed binding ID>; 예시 Bubble 표현Selected Binding's binding_id; 현재 비즈니스 레코드의 값을 사용하고, 아래 제한과 비교해 검증하십시오.

asset_reftext · 기본값: —: 예시 값<returned asset_ref>; 예시 Bubble 표현Selected B2Asset's asset_ref; 서비스에서 제공하는 안정적인 불투명 수락 자산 ID. 선택해도 사용자 권한을 우회하지 않습니다.

반환

ok · yes/nostatus · texterror_code · textasset_ref · textdisplay_name · textmime_type · textsize_bytes · numbercreated_at · textvisibility · textpublic_url · textprovider_status · textinspection_status · textmetadata_label · text

상태 및 이벤트

예정된 워크플로우. 현재 베타에서는 아직 사용할 수 없습니다.

상태

status · text

이 작업의 현재 결과입니다. 성공을 저장하기 전에 일치하는 완료 이벤트를 사용하십시오.

is_busy · yes_no

작업이 진행 중입니다. 다른 작업을 시작하기 전에 기다리세요.

upload_id · text

이 항목 또는 작업의 식별자. 일치하는 앱 기록과 함께 보관하십시오. 불확실한 결과를 재시도할 때 동일한 요청 식별자를 사용하십시오.

upload_status · text

이 작업의 현재 결과입니다. 성공을 저장하기 전에 일치하는 완료 이벤트를 사용하십시오.

asset_ref · text

이 항목 또는 작업의 식별자. 일치하는 앱 기록과 함께 보관하십시오. 불확실한 결과를 재시도할 때 동일한 요청 식별자를 사용하십시오.

display_name · text