Xodera Plugins · Bubble Native

Xodera B2 Files Native

Giữ các tệp đính kèm của ứng dụng trong kho lưu trữ Backblaze B2 của bạn. Cho phép người dùng được phép tải lên, duyệt và tải xuống tệp, và chọn rõ ràng khi nào tệp có thể được chia sẻ công khai.

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.

Xây dựng quy trình làm việc ↓Cài đặt plugin ↗Native Lab

Tài liệu được rà soát ngày 6 tháng mười một năm 2026

Ví dụ thực tế

Lưu trữ tệp đính kèm công việc trong bucket riêng tư của nhà phát triển.

Một công việc Bubble cần một tham chiếu lưu trữ bền vững mà không coi URL tải xuống có thời hạn như là định danh tệp.

`bucket_binding_id = an allowed binding to your own private bucket`; các `local_uri`, `display_name`, `mime_type` và `expected_size` động mô tả tệp cục bộ đã chọn.

Dự kiến: Check local source → Upload file → chờ `upload_verified`. Quy trình của bạn sau đó lưu `asset_ref` và siêu dữ liệu vào bản ghi Job sở hữu.

Sử dụng `asset_ref`, `size_bytes`, `mime_type` và `upload_status`. Sau này, Resolve private read có thể cung cấp URL tạm thời cho việc sử dụng được ủy quyền.

Nếu việc lưu cơ sở dữ liệu thất bại sau `upload_verified`, hãy thử lại cập nhật DB với cùng tham chiếu tài sản thay vì tải lên khác. Kiểm tra kết quả của `upload_pending` bằng cách sử dụng Check or recover upload status và cùng ID tải lên.

Dự kiến. Tài khoản B2 của bạn chịu chi phí lưu trữ và tải xuống.

Xây dựng một thư viện đính kèm sở hữu với các bản ghi tệp bền vững

Thư viện tệp cần tên, loại và phân trang cũng như cách mở tài sản đã chọn sau này.

Bản ghi File của ứng dụng bạn lưu trữ một `asset_ref` đã chấp nhận, tên hiển thị, MIME và quan hệ chủ sở hữu/job sau khi tải lên đã được xác minh; không sử dụng URI cục bộ làm định danh đám mây của nó.

Dự kiến: sử dụng List my B2 files để xây dựng danh sách đính kèm. asset_refs xác định các tệp; các giá trị cùng chỉ mục cung cấp tên và loại của chúng. Khi chọn một tệp, truyền asset_ref của nó tới Get asset metadata hoặc Download accepted version.

`has_more` và `next_cursor` thuộc về truy vấn hiện tại. Một tải xuống hoàn thành sẽ trả về `local_output_uri`; đó là bản sao cục bộ trên thiết bị, không phải liên kết công cộng vĩnh viễn.

Đặt lại phân trang sau khi thay đổi binding/tài khoản/truy vấn. Khi `transfer_error`, giữ lại File Thing hiện có và hiển thị `error_code`; không thay thế im lặng bằng một phiên bản khác ở phía nhà cung cấp.

Dự kiến. Tài khoản B2 của bạn chịu chi phí lưu trữ và tải xuống.

Thực hiện việc công bố và xóa phiên bản chính xác một cách có chủ đích

Nhân viên không nên vô tình lộ một tệp đính kèm riêng tư hoặc xóa mọi phiên bản khi thay thế hình ảnh.

`asset_ref = the selected accepted version`; ràng buộc bucket và quyền truy cập tệp của ứng dụng phải cho phép thao tác yêu cầu.

Hiển thị mức hiển thị hiện tại, yêu cầu xác nhận rõ ràng, sau đó thực hiện Change public sharing. Đối với việc xóa, gọi Delete accepted version kèm xác nhận; giữ siêu dữ liệu ứng dụng cho đến khi kết quả đã được xác nhận.

Sau `share_changed`, chỉ sử dụng `visibility` và `public_url` khi việc chia sẻ công khai đã được ủy quyền rõ ràng. Sau `delete_completed`, cập nhật bản ghi File sở hữu; `delete_pending` không phải là việc xóa cuối cùng.

Kiểm tra kết quả của một thao tác không chắc chắn thay vì giả định thành công. Các URL đọc của nhà cung cấp đã phát hành trước có thể vẫn hợp lệ cho đến khi hết hạn; việc xóa một hàng DB hoặc tắt chia sẻ không thu hồi các byte đã tải xuống.

Dự kiến. Tài khoản B2 của bạn chịu chi phí lưu trữ và tải xuống.

Những gì hiện đang hoạt động

Plugin dự kiến. Hiện chưa được cài đặt hoặc khả dụng để sử dụng. Hướng dẫn dưới đây mô tả quy trình làm việc tệp dự định.

Xây dựng quy trình làm việc

Dự kiến

Quy trình dự kiến. Hiện chưa khả dụng trong bản beta hiện tại.

Các ví dụ này sử dụng các bản ghi ứng dụng như Lesson, Message và Order. Hãy thay thế chúng bằng các kiểu dữ liệu và tên phần tử của bạn. Các địa chỉ phương tiện mẫu phải được thay thế bằng các tệp của bạn.

Dự kiến: trong cài đặt dự án của bạn, chọn lưu trữ B2 và bucket cho phép. Đặt quyền riêng tư, tiền tố thư mục và các loại tệp cũng như kích thước được chấp nhận.
Sử dụng List B2 bindings để hiển thị các lựa chọn lưu trữ cho phép. Sử dụng List my B2 files để hiển thị các tệp của người dùng hiện tại và Get my B2 file info để xem chi tiết.
Chọn một tệp. Đặt bucket_binding_id, local_uri, display_name, mime_type và expected_size, sau đó chạy Upload file. Hiển thị tiến độ, nhưng chờ upload_verified trước khi coi tệp là đã lưu.
Lưu asset_ref trong bản ghi ứng dụng của bạn. Sử dụng nó cho Get asset metadata, Resolve private read hoặc Download accepted version. Change public sharing và Delete accepted version yêu cầu xác nhận riêng.

Sơ đồ quy trình làm việc — không phải ảnh chụp màn hình ứng dụng

Cấu hình một lần

Kích hoạt khóa được lên kế hoạch cho plugin này. Tạo hoặc chọn dự án ứng dụng Bubble trong BestPlugins → Dashboard → Plugins. Chọn Xodera B2 Files Native, sao chép khóa, sau đó mở Bubble → Plugins → Xodera B2 Files Native và dán vào project_api_key. Lưu một lần; sau đó sử dụng các hành động bên dưới. Mỗi plugin trong mỗi dự án có khóa riêng.

Sử dụng tài khoản Backblaze B2 của riêng bạn và chọn bucket cho ứng dụng này. Quyết định ai có thể đọc và tải lên tệp. Lưu tên các trường người dùng có liên quan (có/không) trong b2_reader_permission_field và b2_writer_permission_field; mặc định là b2_files_reader và b2_files_writer. Chỉ quản trị viên được ủy quyền mới nên thay đổi các quyền người dùng này.

Cấu hình một lần

Tạo hoặc chọn dự án ứng dụng Bubble của bạn tại BestPlugins → Dashboard → Plugins.
Chọn plugin này và sao chép khóa dự án của nó.
Dự kiến: Mở Bubble → Plugins → Xodera B2 Files Native; dán khóa vào project_api_key và lưu.
Thêm phần tử, chọn dữ liệu ứng dụng của bạn và xây dựng quy trình làm việc bên dưới.
Hiện chỉ có quyền truy cập beta riêng. Cài đặt công cộng và kích hoạt trả phí chưa mở.

Cài đặt và đăng ký

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.

Lưu kết quả vào ứng dụng của bạn

Tệp đính kèm mẫu: asset_ref, báo cáo/đơn hàng liên quan, chủ sở hữu, display_name, mime_type và size_bytes. Lưu chúng sau upload_verified. Sử dụng asset_ref để mở lại tệp sau này; địa chỉ đọc tạm thời hoặc đường dẫn trên một thiết bị không phải là tham chiếu tệp vĩnh viễn. Nếu lưu bản ghi cơ sở dữ liệu thất bại, hãy thử lưu lại bản ghi đó thay vì tải lên tệp lại.

Lỗi, hủy và khôi phục

Nếu kết quả tải lên không xác định, giữ upload_id và sử dụng Check or recover upload status. Không tự động tải lên bản sao khác. Hủy sẽ ảnh hưởng đến quá trình truyền chưa hoàn thành, không phải tệp đã lưu. Nếu quyền truy cập hết hạn, yêu cầu tệp lại thay vì sử dụng lại địa chỉ tạm thời cũ.

Khả năng và giới hạn

Kích thước tệp tối đa dự kiến: 256 MiB, hoặc giới hạn bucket thấp hơn mà bạn chọn. Chi phí lưu trữ và tải xuống Backblaze thuộc về tài khoản B2 của bạn. Các tệp trong bucket công khai luôn công khai ngay cả khi bản ghi ứng dụng liên quan là riêng tư. Không có cam kết quét virus, tải lên đa phần, tạm dừng hoặc khôi phục sau khi ứng dụng kết thúc.

Cài đặt, hành động và kết quả

Sử dụng các tên này trong Bubble. Các tính năng dự kiến được đánh dấu riêng.

Cài đặt beta khả dụng

Cài đặt phần tử

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

Trạng thái

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

Sự kiện

file_selectedupload_startedupload_transport_completedupload_verifiedupload_pendingbuckets_loadedbucket_selectedlist_loadedmetadata_loadedread_resolveddownload_completedshare_changeddelete_completeddelete_pendingbrowse_loadedtransfer_cancelledcleanup_pendingtransfer_errorsession_cleared

Hành động và đầu vào của chúng

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

Cài đặt phần tử · 14

Quy trình dự kiến. Hiện chưa khả dụng trong bản beta hiện tại.

bucket_binding_idtext · Mặc định: "": Giá trị ví dụ<binding returned by List B2 bindings>; Ví dụ biểu thức BubbleSelected Binding's binding_id; Lựa chọn lưu trữ được trả về bởi List B2 bindings. Sử dụng ID của nó cho tệp này.

local_uritext · Mặc định: "": Giá trị ví dụfile:///app-cache/attachment.jpg; Ví dụ biểu thức BubbleOffline Files' local_uri; Vị trí tệp có thể đọc được trên thiết bị này. Nó không phải là liên kết tải xuống trực tuyến.

display_nametext · Mặc định: "": Giá trị ví dụreport-photo.jpg; Ví dụ biểu thức BubbleSelected Attachment's display_name; Sử dụng giá trị của bản ghi kinh doanh hiện tại; xác thực nó so với các giới hạn bên dưới.

mime_typetext · Mặc định: "": Giá trị ví dụimage/jpeg; Ví dụ biểu thức BubblePhoto Editor's output_mime; Sử dụng giá trị của bản ghi kinh doanh hiện tại; xác thực nó so với các giới hạn bên dưới.

expected_sizenumber · Mặc định: 0: Giá trị ví dụ246975; Ví dụ biểu thức BubbleOffline Files' size_bytes; Sử dụng giá trị của bản ghi kinh doanh hiện tại; xác thực nó so với các giới hạn bên dưới.

metadata_jsontext · Mặc định: "": Giá trị ví dụ{"label":"field-report"}; Ví dụ biểu thức BubbleSelected Attachment's safe_metadata_json; JSON tùy chọn với thông tin ứng dụng như nhãn báo cáo. Giữ kích thước nhỏ và tránh dữ liệu cá nhân.

asset_reftext · Mặc định: "": Giá trị ví dụ<returned asset_ref>; Ví dụ biểu thức BubbleSelected B2Asset's asset_ref; Danh tính tài sản đã chấp nhận ổn định, không trong suốt từ dịch vụ. Việc chọn nó không bao giờ bỏ qua quyền ủy quyền của người dùng.

is_activeyes_no · Mặc định: true: Giá trị ví dụyes; Ví dụ biểu thức BubbleGuideHost's view_is_active (your yes/no custom state); Đặt yes khi chế độ xem này đang mở. Đặt no khi rời khỏi, để có thể dừng việc phát hoặc công việc hiện tại.

disabledyes_no · Mặc định: false: Giá trị ví dụno; Ví dụ biểu thức BubbleGuideHost's is_busy (your yes/no custom state); Vô hiệu hoá phần tử khi ứng dụng của bạn đang bận hoặc hành động này không khả dụng.

languagetext · Mặc định: "auto": Giá trị ví dụuk; Ví dụ biểu thức BubbleCurrent User's preferred_language; Đặt language=auto để theo dõi ngôn ngữ thiết bị hoặc trình duyệt được hỗ trợ. Nhập mã ngôn ngữ hỗ trợ để chọn một cách rõ ràng.

ui_text_jsontext · Mặc định: "": Giá trị ví dụ{}; Ví dụ biểu thức BubbleApp Settings' player_labels_json (supported keys only); JSON tùy chọn với các nhãn nút được hỗ trợ. Để trống để sử dụng văn bản tích hợp.

titletext · Mặc định: "": Giá trị ví dụLesson 4 — review; Ví dụ biểu thức BubbleSelected Lesson's name; Văn bản hiển thị trong ứng dụng; để trống sẽ dùng văn bản bản địa hóa tích hợp khi được hỗ trợ. Không nhập thông tin xác thực.

show_previewyes_no · Mặc định: false: Giá trị ví dụyes; Ví dụ biểu thức BubbleApp Settings' b2_preview; Hiển thị hoặc ẩn bản xem trước tệp.

show_provider_browseyes_no · Mặc định: false: Giá trị ví dụno; Ví dụ biểu thức BubbleCurrent User's authorized_browse_UI (presentation only); Hiển thị hoặc ẩn các điều khiển duyệt lưu trữ cho người dùng được phép.

Hành động và đầu vào của chúng · 20

Quy trình dự kiến. Hiện chưa khả dụng trong bản beta hiện tại.

List allowed buckets

Không có tham số hành động

Select bucket binding

binding_idtext · Mặc định: —: Giá trị ví dụ<returned allowed binding ID>; Ví dụ biểu thức BubbleSelected Binding's binding_id; Sử dụng giá trị của bản ghi kinh doanh hiện tại; xác thực nó so với các giới hạn bên dưới.

Check local source

Không có tham số hành động

Upload file

acknowledge_public_bytesyes_no · Mặc định: —: Giá trị ví dụno; Ví dụ biểu thức BubblePublic bucket disclosure Checkbox is checked (private bucket: no); Sử dụng giá trị của bản ghi kinh doanh hiện tại; xác thực nó so với các giới hạn bên dưới.

confirm_retryyes_no · Mặc định: —: Giá trị ví dụno; Ví dụ biểu thức BubbleRetry Checkbox is checked after confirmed clean pending status; Sử dụng giá trị của bản ghi kinh doanh hiện tại; xác thực nó so với các giới hạn bên dưới.

Check or recover upload status

upload_idtext · Mặc định: —: Giá trị ví dụ<original returned upload_id>; Ví dụ biểu thức BubbleCurrent UploadIntent's upload_id; Sử dụng giá trị của bản ghi kinh doanh hiện tại; xác thực nó so với các giới hạn bên dưới.

Cancel owned transfer

Không có tham số hành động

Clear local session

Không có tham số hành động

List application files

Không có tham số hành động

Refresh application files

Không có tham số hành động

Load more application files

Không có tham số hành động

Select asset reference

asset_reftext · Mặc định: —: Giá trị ví dụ<returned asset_ref>; Ví dụ biểu thức BubbleSelected B2Asset's asset_ref; Danh tính tài sản đã chấp nhận ổn định, không trong suốt từ dịch vụ. Việc chọn nó không bao giờ bỏ qua quyền ủy quyền của người dùng.

Get asset metadata

asset_reftext · Mặc định: —: Giá trị ví dụ<returned asset_ref>; Ví dụ biểu thức BubbleSelected B2Asset's asset_ref; Danh tính tài sản đã chấp nhận ổn định, không trong suốt từ dịch vụ. Việc chọn nó không bao giờ bỏ qua quyền ủy quyền của người dùng.

Resolve private read

asset_reftext · Mặc định: —: Giá trị ví dụ<returned asset_ref>; Ví dụ biểu thức BubbleSelected B2Asset's asset_ref; Danh tính tài sản đã chấp nhận ổn định, không trong suốt từ dịch vụ. Việc chọn nó không bao giờ bỏ qua quyền ủy quyền của người dùng.

Download accepted version

asset_reftext · Mặc định: —: Giá trị ví dụ<returned asset_ref>; Ví dụ biểu thức BubbleSelected B2Asset's asset_ref; Danh tính tài sản đã chấp nhận ổn định, không trong suốt từ dịch vụ. Việc chọn nó không bao giờ bỏ qua quyền ủy quyền của người dùng.

Browse provider files

prefixtext · Mặc định: —: Giá trị ví dụ""; Ví dụ biểu thức BubbleAuthorized Browse Settings' prefix; Sử dụng giá trị của bản ghi kinh doanh hiện tại; xác thực nó so với các giới hạn bên dưới.

load_moreyes_no · Mặc định: —: Giá trị ví dụno; Ví dụ biểu thức BubbleLoad More button only, for unchanged query; Sử dụng giá trị của bản ghi kinh doanh hiện tại; xác thực nó so với các giới hạn bên dưới.

Change public sharing

asset_reftext · Mặc định: —: Giá trị ví dụ<returned asset_ref>; Ví dụ biểu thức BubbleSelected B2Asset's asset_ref; Danh tính tài sản đã chấp nhận ổn định, không trong suốt từ dịch vụ. Việc chọn nó không bao giờ bỏ qua quyền ủy quyền của người dùng.

enabledyes_no · Mặc định: —: Giá trị ví dụno; Ví dụ biểu thức BubblePublic Share Checkbox is checked after separate confirmation; Sử dụng giá trị của bản ghi kinh doanh hiện tại; xác thực nó so với các giới hạn bên dưới.

confirmyes_no · Mặc định: —: Giá trị ví dụyes — explicit confirmation only; Ví dụ biểu thức BubbleConfirm Checkbox is checked; Sử dụng giá trị của bản ghi kinh doanh hiện tại; xác thực nó so với các giới hạn bên dưới.

Delete accepted version

asset_reftext · Mặc định: —: Giá trị ví dụ<returned asset_ref>; Ví dụ biểu thức BubbleSelected B2Asset's asset_ref; Danh tính tài sản đã chấp nhận ổn định, không trong suốt từ dịch vụ. Việc chọn nó không bao giờ bỏ qua quyền ủy quyền của người dùng.

confirmyes_no · Mặc định: —: Giá trị ví dụyes — explicit confirmation only; Ví dụ biểu thức BubbleConfirm Checkbox is checked; Sử dụng giá trị của bản ghi kinh doanh hiện tại; xác thực nó so với các giới hạn bên dưới.

List B2 bindings

environmenttext · Mặc định: —: Giá trị ví dụdevelopment; Ví dụ biểu thức BubbleApp Settings' selected_environment; Sử dụng giá trị của bản ghi kinh doanh hiện tại; xác thực nó so với các giới hạn bên dưới.

Trả về

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

List my B2 files

environmenttext · Mặc định: —: Giá trị ví dụdevelopment; Ví dụ biểu thức BubbleApp Settings' selected_environment; Sử dụng giá trị của bản ghi kinh doanh hiện tại; xác thực nó so với các giới hạn bên dưới.

binding_idtext · Mặc định: —: Giá trị ví dụ<returned allowed binding ID>; Ví dụ biểu thức BubbleSelected Binding's binding_id; Sử dụng giá trị của bản ghi kinh doanh hiện tại; xác thực nó so với các giới hạn bên dưới.

limitnumber · Mặc định: —: Giá trị ví dụ50; Ví dụ biểu thức BubbleGallery Settings' page_size; Sử dụng giá trị của bản ghi kinh doanh hiện tại; xác thực nó so với các giới hạn bên dưới.

cursortext · Mặc định: —: Giá trị ví dụ""; Ví dụ biểu thức BubblePrevious List my B2 files result's next_cursor; empty on first page; Sử dụng giá trị của bản ghi kinh doanh hiện tại; xác thực nó so với các giới hạn bên dưới.

Trả về

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 · Mặc định: —: Giá trị ví dụdevelopment; Ví dụ biểu thức BubbleApp Settings' selected_environment; Sử dụng giá trị của bản ghi kinh doanh hiện tại; xác thực nó so với các giới hạn bên dưới.

binding_idtext · Mặc định: —: Giá trị ví dụ<returned allowed binding ID>; Ví dụ biểu thức BubbleSelected Binding's binding_id; Sử dụng giá trị của bản ghi kinh doanh hiện tại; xác thực nó so với các giới hạn bên dưới.

asset_reftext · Mặc định: —: Giá trị ví dụ<returned asset_ref>; Ví dụ biểu thức BubbleSelected B2Asset's asset_ref; Danh tính tài sản đã chấp nhận ổn định, không trong suốt từ dịch vụ. Việc chọn nó không bao giờ bỏ qua quyền ủy quyền của người dùng.

Trả về

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

Trạng thái và sự kiện

Quy trình dự kiến. Hiện chưa khả dụng trong bản beta hiện tại.

Trạng thái

status · text

Kết quả hiện tại của hành động này. Sử dụng sự kiện hoàn thành tương ứng trước khi lưu thành công.

is_busy · yes_no

Công việc vẫn đang tiến hành. Vui lòng chờ trước khi bắt đầu hành động khác.

upload_id · text

Định danh cho mục hoặc hành động này. Giữ nó cùng bản ghi ứng dụng tương ứng. Sử dụng cùng một định danh yêu cầu khi thử lại kết quả không chắc chắn.

upload_status · text

Kết quả hiện tại của hành động này. Sử dụng sự kiện hoàn thành tương ứng trước khi lưu thành công.

asset_ref · text

display_name · text