Kanorio
Kanorio 開発者

クラウド基盤

メディアとアセット

公開ファイルと保護ファイル、画像バリアントとプレースホルダー、動画ストリーミング、処理ステータスを備えたメディアライブラリについて説明します。

提供中

サイトで使用されるすべての画像、動画、ファイルはメディアライブラリに保存されます。コンテンツはアセットIDによってファイルを参照し、レスポンスではIDがURL、サイズ、代替テキスト、プレースホルダーに解決されます。

コアオブジェクト

  • アセット: 公開範囲、タグ、代替テキスト、フォーカスポイント、処理ステータスを持つファイル。公開ファイルはCDNから配信されます。コース動画などの保護されたファイルは、有効期間の短い署名付きURLを通じてのみアクセス可能です。
  • 画像バリアント: オンデマンドでリサイズされたバージョンに加え、すべての画像に対して小さなぼかしプレースホルダーが生成されます。
  • 動画ストリーミング: 動画はアダプティブストリームに変換され、保護された動画には署名付きセグメントが適用されます。

APIの役割

  • Management APIを使用して、URLまたはファイルによるアップロード、大容量ファイル用の直接アップロードURLの要求、クライアント用のアップロードリンクの作成、ストックフォトのインポートが可能です。
  • メディアを参照するすべてのContent Delivery APIのレスポンスには、assetsマップが含まれます。
  • <kanorio-media>および<kanorio-lightbox>を使用して、メディアの再生や画像の表示を行います。
  • Webhooksは、アセットの準備が完了したか、処理に失敗したかを通知します。

API で利用できる範囲

  • Public & protected media, responsive images, LQIP placeholders, lightbox & HLS video streaming提供中
    API
    Management API media.* (images and files with visibility public/protected, tags and processing; protected files have no public URL and need only media:manage; media.get renditions[] for public files incl. hls and thumbnails once a video is transcoded, streaming none/processing/partial/ready; media.update focus, alt text, tags, visibility switch and streaming: true to transcode now); Delivery assets map (url, width, height, alt, focus, watermarked, placeholder 16px WebP data URL, processing, video renditions + streaming; public assets only); Customer API POST /units/:id/open returns renditions with a signed hls path for protected videos (expiresIn follows the video length); GET /api/v1/site mediaProtection
    Elements
    <kanorio-media src mime-type>, <kanorio-lightbox images='[…]'> (reads the site's media protection when protection is omitted)
    ホスト型サイト
    /media library; gallery & media sections
    Webhooks
    media.asset.ready, media.asset.failed (background processing of a file: thumbnails, visibility moves, transcoding)

API リファレンス

Webhook イベント

  • media.asset.ready · Fired when background processing of a media file (thumbnail, visibility move, transcoding) finishes and the file is ready to use.
  • media.asset.failed · Fired when background processing of a media file fails after retries; the site team also gets an in-app notification.
  • site.storageQuota.alert · Fired when site storage reaches 80%, is exhausted, auto-upgrades, or add-on payment fails.

Elements

  • <kanorio-media> · Public media player for a URL.
  • <kanorio-lightbox> · Image lightbox with zoom, keyboard navigation, and download and share controls that follow the site's media protection.

最近の変更

  • 2026-11-01 Media: adaptive streaming (HLS) versions of videos
  • 2026-10-31 Media: visibility is a file property
  • 2026-10-24 billableBytes, edgeColor, ogImageFraming, imageFramings, and 20 GB storage add-on levels
  • 2026-10-23 Per-device image aspect ratio and image framing in sections
  • 2026-10-23 Protected files for deliverables, file uploads and large-file uploads
変更履歴をすべて見る

サイト運営者向け

管理画面での使い方はヘルプセンターで説明しています。

ヘルプセンターを開く