ローカルメディアを表示する

ファイルまたはバイト列の不変コピーを登録し、URIをメディア部品へ渡します。

photo = app.resources.file("photo.png")
# Surface内:
ui.image(photo)

TypeScriptはapp.resources.file(path, mimeType?)・app.resources.bytes(data, mimeType)、Rustはapp.resources.file(path, Option<&str>)?・app.resources.bytes(&data, mime)?です。いずれもomochi://resources/<id>を返します。

ブラウザがアプリのファイルシステムを読める必要はありません。開発ブリッジとローカル・リモートHubに対応します。登録は上限付きの同期I/Oなので、大きなファイルは起動前に登録するか別スレッドで扱います。

再生中を含め、Surfaceが参照する間は登録を維持してください。release(uri)は以後の読み取りを止めます。内容が変わったら再登録が必要です。既定の上限は1ファイル1 GiB、合計4 GiB。ファイルはMIME型を推定し、バイト列は明示が必要です。コーデック変換はしません。

Python・TypeScriptの例とRust SDKのmedia exampleを参照できます。独自Transportはリソースフレームを保持し、要求元接続へ応答する必要があります。通信仕様も確認してください。

クライアントごとのメディア対応

開発ブリッジとローカルHTTP/WSのHubではリソースのGET・HEAD・Rangeを利用できます。ホストされたブラウザーのオーナー・共有接続では、公開された画像をネイティブHubで検証して配信し、音声・動画は利用不可として表示します。画像URIはSurfaceの正式な状態に完全な文字列として含めてください。組み立てたURLやMarkdown内に埋め込まれた画像の宛先だけでは、リモート共有への公開と見なしません。

Flutterのメディア対応にはプラットフォーム差があります。詳細はアプリガイドを参照してください。SDKの登録上限と、配信・画像デコード側の上限は別です。