Drive モジュール

Drive モジュールはメディアファイルのアップロード・変換・保存を担う． ノートへの添付に使えるメディアファイルはすべてこのモジュールを経由して管理される．

Medium (メディアファイル)

ノートに添付できるメディアファイルを表すエンティティ． アップロード時に適切なフォーマットへの変換とサムネイル生成が行われる．

TypeScript 上ではメディアファイル固有の ID 型を次のように定義する．

export type MediumID = ID<Medium>;

Medium は次の属性を持つ．

• id：MediumID
  • このメディアファイルを一意に識別する Snowflake ID
• name：ファイル名
• authorId：このメディアファイルをアップロードしたアカウントの AccountID
• hash：Blurhash によるプレースホルダー文字列
  • ファイルの読み込み完了前に表示するぼかしプレースホルダーとして利用される
  • 画像以外の MIME タイプでは空文字列となる場合がある
• mime：MIME タイプ（例：image/jpeg）
• nsfw：センシティブコンテンツのフラグ
  • true の場合，クライアントは閲覧前に警告を表示することが期待される
• url：変換後のメディアファイルの URL
• thumbnailUrl：サムネイル画像の URL