deki-sdcard
SD カード対応。カードをマウントし、アセットマネージャーが実行時にそこからストリーミングできるようにします。
リポジトリ: github.com/dekiengine/deki-sdcard · 最新リリース: 0.19.0 · エンジン 0.19.0 以降が必要
DekiEditor --packages-add deki-sdcard <project> か、パッケージマネージャーからインストールします。エンジン自身のコンポーネントと C++ API は Deki のドキュメントにあります。
エディターでは SD Card と表示されます。
コンポーネント
| コンポーネント | カテゴリ | 説明 |
|---|---|---|
| SDCardComponent | システム | 起動時に SD カードをマウントし、そこからアセットを読み込めるようにします。 |
コンポーネントリファレンス
SDCardComponent
起動時に SD カードをマウントし、そこからアセットを読み込めるようにします。
インスペクターでの名前: SD カードコンポーネント · カテゴリ: システム · 型: DekiSdCard::SDCardComponent
| プロパティ | 型 | デフォルト | 制約 | 説明 |
|---|---|---|---|---|
| mode | enum | "SPI" | SPI, SDMMC1Bit, SDMMC4Bit | カードの配線方法です。SPI は 4 本のピンが必要で、どのボードでも使えます。SDMMC は高速ですが専用のピンが必要で、4 ビットは 1 ビットより高速です。 |
| mosiPin | int32 | 23 | 0 から 48。mode が許すときに表示 | SPI モード: ボードが送信に使う GPIO で、カードの DI または CMD パッドにつなぎます。 |
| misoPin | int32 | 19 | 0 から 48。mode が許すときに表示 | SPI モード: ボードが受信に使う GPIO で、カードの DO または DAT0 パッドにつなぎます。 |
| csPin | int32 | 5 | 0 から 48。mode が許すときに表示 | SPI モード: チップセレクトです。このカードとやり取りしている間は Low に保たれ、そのおかげで他のデバイスとバスを共有できます。 |
| spiHz | int32 | 20000000 | 1 から 40。mode が許すときに表示 | SPI のクロック速度です。20 MHz はほとんどのカードと短い配線に合います。マウントはできても読み込みがうまくいかないカードは、たいてい値を下げると直ります。 |
| sdmmcHz | int32 | 20000000 | 1 から 40。mode が許すときに表示 | SDMMC のクロック速度です。20 MHz から始めるのが安全です。配線が短く、長さのそろったボードでは 40 MHz でも動きます。 |
| cmdPin | int32 | 15 | 0 から 48。mode が許すときに表示 | SDMMC モード: ボードがカードとやり取りするためのコマンド線です。 |
| d0Pin | int32 | 2 | 0 から 48。mode が許すときに表示 | SDMMC モード: データ線 0 です。1 ビットモードではこのデータ線だけを使います。 |
| d1Pin | int32 | 4 | 0 から 48。mode が許すときに表示 | SDMMC 4 ビットモード: データ線 1 です。1 ビットモードでは使いません。 |
| d2Pin | int32 | 12 | 0 から 48。mode が許すときに表示 | SDMMC 4 ビットモード: データ線 2 です。1 ビットモードでは使いません。 |
| d3Pin | int32 | 13 | 0 から 48。mode が許すときに表示 | SDMMC 4 ビットモード: データ線 3 です。1 ビットモードでは使いません。 |
| clkPin | int32 | 18 | 0 から 48 | SDMMC モード: カードを駆動するクロック線です。 |
| cdPin | int32 | -1 | -1 から 48 | カード検出ピンです (ソケットに検出スイッチがある場合)。ない場合は -1 で、カードは常に挿さっているとみなします。 |
| required | bool | true | カードをマウントできないときに起動を止めます。オフの場合はカードなしで起動を続けます。画面と操作は使えるようになりますが、カードにあるゲームのアセットは読み込まれません。側面にカードスロットがある携帯機向けです。 |
変更履歴
変更履歴は英語です。
0.19.0
Changed
- minEngine 0.19.0: built against engine 0.19.0, whose component metadata records the package each class is in. A build of this package from before does not load and is rebuilt.
Added
- Japanese, Simplified Chinese and Korean: editor/lang/ja.json, zh.json and ko.json translate the names, tooltips and enum values this package's components show in the Inspector.
0.18.0
Changed
- minEngine 0.18.0. Reflection ABI 21: the package must be rebuilt.
- Names follow the code style (deki-engine/docs/codestyle): types, functions and enum values are PascalCase, constants kPascalCase, members m_PascalCase, locals and parameters camelCase. The code is formatted with clang-format 22.
- The functions the editor finds by name are PascalCase: DekiSDCardRegisterComponents, DekiSDCardGetAutoComponentCount, DekiSDCardEnsureRegistered and the rest. Built against engine ABI 21; a build of this package from before does not load and is rebuilt.
- SDCardMode values are SDMMC1Bit and SDMMC4Bit. Scenes that saved the old names still load.
Removed
- The former names from before 0.16.0 (bare class names, and deki-gpio's DekiEsp32::ESP32PinSetup). A scene that old is upgraded with 0.17 first.
それ以前のリリース: CHANGELOG.md
パッケージのリフレクションデータから生成しています (エンジン 0.19.0)。プロパティ名はシーンファイルで使われるキーです。名前を変えても別名が残ります (互換性)。
