Media Kitとの連携

@blocklet/uploaderパッケージは、Media Kit blockletとのシームレスでゼロコンフィギュレーションの連携を実現するために設計されています。Media Kitは、メディアの保存、管理、処理のための一元化されたサービスを提供します。Uploaderコンポーネントが同じ環境にMedia Kitがインストールされていることを検出すると、開発者による追加の設定なしに自動的にその機能を強化します。

この自動連携により、ファイルストレージが一元化され、すべてのblockletで一貫したアップロードルールが適用され、AI画像生成のような高度な機能が動的に有効になります。この動作は、効率的な体験のためにデフォルトで有効になっていますが、独自のblockletのバックエンド内でアップロードを処理する必要がある場合は、オプトアウトすることもできます。

仕組み：自動検出と設定

連携プロセスは完全に自動化されており、コンポーネントの初期化時に簡単な2段階のプロセスに従います：

以下の図は、この自動設定フローを示しています：

主な利点

Media Kitとの連携は、追加の開発作業なしにいくつかの強力な利点を提供します。

オプトアウト：連携の無効化

独自のバックエンドロジックとストレージ（@blocklet/uploader-serverを使用）でアップロードを管理する必要があるシナリオでは、Media Kitとの自動連携を無効にできます。これは、UploaderコンポーネントのapiPathPropsオブジェクトに特定のpropsを渡すことで行います。

Uploader with Media Kit Integration Disabled

import { Uploader } from '@blocklet/uploader/react';

export default function MyComponent() {
  return (
    <Uploader
      popup
      apiPathProps={{
        // Media Kitからのリモート設定の取得を防止
        disableMediaKitStatus: true,
        // Media KitへのAPIコールのルーティングを防止
        disableMediaKitPrefix: true,
      }}
      // ここで独自の制限を提供する必要があります
      // そして@blocklet/uploader-serverで独自のバックエンドを設定します。
      coreProps={{
        restrictions: {
          maxFileSize: 1024 * 1024 * 5, // 5MB
          allowedFileTypes: ['image/jpeg', 'image/png'],
        },
      }}
    />
  );
}

これらのプロパティを設定することで、Uploaderコンポーネントはスタンドアロンモードで動作し、自身のpropsとアプリケーション内で設定されたバックエンドサービスに完全に依存します。詳細については、バックエンド設定ガイドをご覧ください。