インラインビデオ：ルールと例

インラインビデオとは、記事の読み上げフロー内に配置された、ホスティングまたは外部埋め込みの録画であり、1つの bounded なアイデアを実演、説明、または文書化するためのものです。可視ラベル、意図的なポスターフレーム、再生コントロール、キャプション、再生時間、および完全なトランスクリプトを含みます。これらの周辺テキストがなければ、ラベルのないプレーヤーは、視聴できない、または視聴しないすべての読者にとって不可視であり、テキストを抽出するシステムにとってはほぼ空の状態になります。

保留中のポスターコメントはアセット参照ではなく、キャプチャ仕様です。周囲のHTMLは、メディア制作が完了する前に必要な読み上げ順序を示しています。

この要素が重要な理由

ビデオは、動き、タイミング、声、または時間の経過に伴う変化が意味を持つ場合に、説明コストを削減します。読者は、メニューがどのように開くか、物理的な製品がどのように動くか、またはスピーカーがどのように結論を補足するかを確認できます。視聴には注意、音声またはキャプション、時間、そして多くの場合、読書よりも多くのデータが必要なため、明確なラベルと再生時間により、読者はそのコストを判断できます。

ポスターフレームは、再生前にその判断に影響を与えます。代表的な静止画は、録画内容の視覚的な約束として機能します。目を閉じたランダムなフレーム、ローディングスピナー、無関係なタイトルカードは、コンテンツが不注意に見え、読者がその主題を知るために再生を押さざるを得なくなります。ポスターは、ビデオが実際に説明する状態、人物、オブジェクト、または結果を明らかにする必要があります。

機械抽出可能性とは、ソフトウェアがプレゼンテーションを再現することなく、コンテンツユニットの意味を復元できる能力です。ベアなiframeは通常、プロバイダーのURL以上のものを公開しません。ラベル付き要素は、タイトル、要約、再生時間、日付、ポスター、キャプション、トランスクリプト、安定した識別子を公開します。検索、翻訳、アクセシビリティ、および検索システムは、これにより bounded な説明を理解できます。

したがって、トランスクリプトは要素の一部であり、オプションのダウンロードではありません。音声による主張、話者の変更、意味のある音、および視覚的なアクションをドキュメント順に保存します。キャプションは再生体験をサポートし、トランスクリプトはページをサポートします。共有の要素作成ルール に従って、セマンティック優先順位、ディレクティブ構文、および本文マッピングを確認してください。このページは、トランスクリプト、ポスター、再生時間、およびビデオ固有のアクセシビリティフィールドを要求する場合に優先されます。

使用するタイミング

インラインビデオは、時間ベースの証拠が静止画像と散文よりも bounded なポイントを明確に伝える場合に使用します。適切なケースには、インターフェース操作、物理的テクニック、可視的な遷移、専門家の説明、モーションに依存する製品動作、またはその配信自体が証拠となる記録された結果が含まれます。

録画を発注する前に、代替テストを適用してください。1枚のスクリーンショットと2つの文章で同じポイントを説明できる場合は、それらを使用してください。読み込みが速く、スキャンが速く、更新コストも低くなります。ビデオは、シーケンス、ペース、動き、声、または観察された動作が理解を変える場合にその地位を獲得します。

類似しているが適切でないケースには以下が含まれます：

• 無関係な段落内の長いウェビナー： 専用のビデオページにリンクするか、フルビデオ埋め込みセクションを使用します。インライン要素はローカルの議論に資する必要があり、隣接する主題を1時間も取り込んではいけません。
• 無音のループ装飾： それはモーションデザインであり、編集用ビデオではありません。削除するか、動きを抑えた装飾メディアとして扱います。
• 説明の代わりに使用される画面録画： 手順と成功状態をテキストで記述します。ビデオで実演することはできますが、タスクを完了する唯一の方法であってはなりません。
• コンテキストなしで切り取られた顧客の引用： ショートクリップは、話者、関係、録画日、承認、および周辺の主張が開示されている場合にのみケーススタディをサポートできます。
• 価値がパーソナリティだけのビデオ： 声、配信、または話者の権威が関連する場合にのみ使用します。読者に、すでにページにあるコピーを読み上げるプレゼンターを視聴させないでください。
• 複数の同種クリップ： 録画間の選択がタスクである場合は、ギャラリーまたは専用のメディアセクションを使用します。インラインプレーヤーを積み重ねないでください。

配置場所

ビデオは、読者が学ぶ内容や観察する内容を説明する段落の直後に配置します。タイトル、再生時間、要約をプレーヤーの前に配置します。トランスクリプトはその直後に配置し、完全なテキストが再生コードなしでHTMLに残っている場合にのみ折りたたみます。

手順の中では、プレーヤーは記述されたアクションシーケンスの後、トラブルシューティングの前に配置します。読者は視聴しなくても行動でき、その後録画を使用して動きやインターフェースの状態を確認できるようにします。議論やケーススタディでは、録画の前に主張を述べ、その後に限界を解釈します。

別のプレーヤー、自動再生アニメーション、大きなコールトゥアクション、フォーム、または計算機の隣に配置しないでください。競合するコントロールは不明確な焦点を生み出します。テーブルセル、リストアイテム、コールアウト、タブ、カルーセル、アコーディオンパネル、またはクリッカブルカードの中に配置しないでください。トランスクリプトは開示コントロールを使用しても構いませんが、ビデオ全体がそうであってはなりません。

タイトル、要約、ポスター、プレーヤー、再生時間、トランスクリプトコントロール、およびクレジットを1つのfigure境界内に収めてください。ソースノートは直後に続いても構いません。プレーヤーとそのトランスクリプトを広告、プロモーション、または無関係なセクションで決して分離しないでください。

構成要素

1. 可視タイトル： タスク、デモンストレーション、イベント、または主張を具体的なHTMLテキストで示します。
2. 要約： 読者が何を見るか、なぜそれが重要かをつなぎ合わせた文で説明します。
3. 再生時間： 再生前の視聴コストを分と秒で示します。
4. ポスターフレーム： 代表的な承認済みフレームを表示し、それ自体がボタンであるかのように装いません。
5. プレーヤーコントロール： 再生、一時停止、シーク、音量、全画面表示、再生速度、キャプションアクセスを提供します。
6. キャプション： ダイアログ、話者の変更、および意味のある非音声オーディオを再生と同期させます。
7. トランスクリプト： 完全な意味のあるシーケンスを選択可能で検索可能なHTMLテキストとして再現します。
8. 視覚的説明： ナレーションが述べていない、画面上の意味のあるアクションや変化を記録します。
9. クレジットとソース： 話者、作成者、録画日、またはエビデンスの出典を必要に応じて特定します。

タイトルはファイル名ではなく、要約は「以下のビデオをご覧ください」ではありません。それぞれは、プレーヤーなしでコピーされた場合でも有用でなければなりません。

デザイン例

すべてのバリアントは同じコンテンツ契約を共有します。配信は変わりますが、ラベリング、キャプション、トランスクリプトの品質、再生の同意、および読み上げ順序は変わりません。

ホスティングデモンストレーション

組織がエンコーディング、キャプション、ポスターの選択、および可用性を管理している場合に、ショート製品またはプロセス録画にはファーストパーティのHTML5プレーヤーを使用します。

プライバシーに配慮した外部埋め込み

その配信、分析、または確立されたチャンネルが必要な場合に、外部プラットフォームを使用します。ポリシーで必要な場合は同意後にのみプロバイダーをロードし、アクティベーション前にプロバイダーを特定し、プロバイダーが録画を削除した場合でもローカルのトランスクリプトを保持します。

ショートインターフェースクリップ

静止画像では伝えるのが難しい1つの状態変化には、簡潔なクリップを使用します。それでもコントロール、一時停止機構、意味のあるテキスト説明、およびトランスクリプトが必要です。自動ループするGIFにしないでください。

インタビューまたはエビデンスクリップ

著作者、表現、または観察された証言が重要な場合に、話者主導のクリップを使用します。その人の名前と役割をHTMLで表示し、編集箇所を開示し、音声と物質的な視覚的証拠の両方を文字起こしします。

パラメータ

これらのフィールドは、ポータブルなコンテンツ契約を形成します。幅、境界線、シャドウ、再生ボタンスタイル、およびブレークポイント動作はレンダラーに属します。

最初の本文見出しはtitleに、最初の段落はsummaryに、残りの本文はtranscriptにマッピングされます。トランスクリプトの時間範囲は、連続した単一話者の説明ではオプションであり、手順、話者の変更、および2分を超える録画では推奨されます。autoplay、loop、および背景音声フィールドは意図的に存在しません。

構文とコード例

各表記法は、同じタイトル、要約、メディアメタデータ、キャプション、およびトランスクリプトを保持します。例のドメインは契約を説明するものであり、本番アセット参照ではありません。

ポータブルMarkdownディレクティブ

:::inline-video{src="https://media.example.com/freshness-filter.mp4" provider=hosted poster="https://media.example.com/freshness-filter-poster.webp" duration="PT1M30S" captions="https://media.example.com/freshness-filter.en.vtt" language=en uploadDate="2026-08-27"}

## Filter pages that need review

See how to apply the Needs review filter and verify the resulting work queue.

**00:00–00:18 — Open the report.** From Audit, open Freshness.

**00:19–00:54 — Apply the filter.** Open Status and choose Needs review.

**00:55–01:30 — Verify the queue.** Confirm that every visible row has the expected status.
:::

Hugoショートコード

{{< inline-video src="https://media.example.com/freshness-filter.mp4" provider="hosted" poster="https://media.example.com/freshness-filter-poster.webp" duration="PT1M30S" captions="https://media.example.com/freshness-filter.en.vtt" language="en" uploadDate="2026-08-27" >}}
## Filter pages that need review

See how to apply the Needs review filter and verify the resulting work queue.

**00:00–00:18 — Open the report.** From Audit, open Freshness.

**00:19–00:54 — Apply the filter.** Open Status and choose Needs review.

**00:55–01:30 — Verify the queue.** Confirm that every visible row has the expected status.
{{< /inline-video >}}

これは意図されたアダプター契約であり、ローカルにショートコードが存在するという主張ではありません。名前付きパラメーターのみを使用します。レンダラーが登録されるまでは、同じフィールドを保持するセマンティックなfigure、video、track、およびトランスクリプトHTMLを使用します。

WordPressブロック

<!-- wp:amicited/inline-video {"src":"https://media.example.com/freshness-filter.mp4","provider":"hosted","poster":"https://media.example.com/freshness-filter-poster.webp","duration":"PT1M30S","captions":"https://media.example.com/freshness-filter.en.vtt","language":"en","uploadDate":"2026-08-27"} -->
<h2>Filter pages that need review</h2>
<p>See how to apply the Needs review filter and verify the resulting work queue.</p>
<video controls preload="metadata" poster="https://media.example.com/freshness-filter-poster.webp">
  <source src="https://media.example.com/freshness-filter.mp4" type="video/mp4">
  <track kind="captions" srclang="en" src="https://media.example.com/freshness-filter.en.vtt" label="English" default>
</video>
<details><summary>Read the transcript</summary><p><strong>00:00–00:18 — Open the report.</strong> From Audit, open Freshness.</p><p><strong>00:19–00:54 — Apply the filter.</strong> Open Status and choose Needs review.</p><p><strong>00:55–01:30 — Verify the queue.</strong> Confirm that every visible row has the expected status.</p></details>
<!-- /wp:amicited/inline-video -->

登録されたWordPressブロックが利用できない場合は、ネイティブのVideo、Heading、Paragraph、およびDetailsブロックを使用します。iframeを貼り付けてローカルのトランスクリプトを省略しないでください。

例

良い例：読み取り代替手段を備えたboundedなデモンストレーション

レビューが必要なページをフィルタリング · 1:30

このビデオは1つのタスクを示しています：フレッシュネスレポートを開き、ステータスフィルターを適用し、結果件数を確認します。ポスターは開かれたフィルターを示し、キャプションはインターフェースラベルを正確に特定し、3部構成のトランスクリプトはすべてのアクションと成功確認を記録します。再生はアクティベーション後にのみ開始されます。

これが機能する理由は、読者が価値と時間コストを予測でき、音声で視聴するか、キャプションで視聴するか、トランスクリプトから同じタスクを完了できるからです。録画は、唯一の説明になることなく、動きと状態変化の証拠を追加します。

悪い例：ラベルのないプレーヤー

これを視聴
サードパーティのiframeが見出しの下に自動的に読み込まれます。ポスターは黒いフレームで、再生時間は表示されず、キャプションはプロバイダー生成で未レビューであり、ページにはトランスクリプトや要約はありません。

悪いバージョンでは、視聴しないすべての読者に推測を強います。抽出者に主題を与えず、プライバシーを気にする読者に再生を選ぶ前にプロバイダーへの接触を求め、録画が消えたときに永続的なテキストを提供せず、不正確なキャプションを事実としてアナウンスする可能性があります。具体的なタイトルと要約、意図的なポスター、再生時間、同意を認識した読み込み、レビュー済みキャプション、完全なローカルトランスクリプト、およびプレーヤー外の記述されたタスクまたは主張で修復してください。

スキーママークアップとアクセシビリティ

インラインビデオは自動的にスキーマ資格を生成しません。VideoObjectは、ページがアクセス可能な録画に対して正確なname、description、thumbnailUrl、uploadDate、duration、およびcontentUrlまたはembedUrlの値を表示可能に提供する場合にのみ使用します。バリデーターを満たすため、または装飾的なクリップを主要なビデオとしてマークするためにフィールドをでっち上げないでください。

関連するビデオは、ページが独立して資格を満たす場合に、適格なArticle、HowTo、またはProductをサポートすることがあります。そのトランスクリプトは、可視ページに存在しない主張やステップを正当化することはできません。

アクセシビリティは再生前から始まります。figureにラベルを付け、タイトルと再生時間をテキストで表示し、コントロールにキーボード操作と可視フォーカスを提供します。自動再生は絶対に行わないでください。一時停止、シーク、音量、速度、キャプション、全画面表示を提供します。サードパーティのプレーヤー内にフォーカスを閉じ込めないでください。全画面表示が閉じた後は、開始コントロールにフォーカスを戻します。

キャプションは同期され、句読点が正しく、録画に対してレビューされている必要があります。声が明らかでない場合は話者を特定し、理解に影響を与える場合は「[通知音]」などの意味のある音を含めます。意味のある視覚情報がメインの音声で述べられていない場合、音声説明が必要です。説明用のトランスクリプトだけでは、タイムドな再生体験を同等にすることはできません。

トランスクリプトは、論理的な順序の実際のHTMLである必要があります。キャンバス、再生専用コンテンツ、非表示テキスト、またはPDFのみのダウンロードであってはなりません。開示コントロールには、アクセシブルな名前と展開状態が必要です。プレーヤーとトランスクリプトは、200%ズームおよび狭い幅で、ページレベルの水平スクロールなしで動作する必要があります。

作成ルール

プレーヤーの周囲の言葉が、ビデオがコンテンツ要素であるか、説明のないオブジェクトであるかを決定します：

• 4～12語の具体的なタイトルを書きます。タスク、デモンストレーション、話者、イベント、または発見事項を名前で示します。「ビデオ」「これを視聴」「もっと詳しく」だけを単独で使用しないでください。
• 15～35語の1つの要約文を書き、何が起こるか、なぜそれが重要かを読者に伝えます。タイトルを繰り返さないでください。
• インライン録画は焦点を絞り、通常5分未満に抑えます。ハード上限は20分です。より長い録画は専用ページに属するか、編集上のセグメンテーションが必要です。
• 再生前に再生時間を表示します。可視テキストにはM:SS、構造化フィールドにはPT1M30SなどのISO 8601を使用します。
• 通常表示サイズで被写体を表現するポスターを選びます。空白のフレーム、スピナー、偶然の表情、欺瞞的な再生ボタン、小さすぎるインターフェーステキスト、未承認の個人情報や顧客情報は避けてください。
• 最終編集に対してキャプションをレビューします。名前、製品ラベル、数字、ドメイン用語、句読点、話者の変更、意味のある音を修正します。
• 意味のあるすべての音声と視覚情報を文字起こしします。要約、チャプタータイトル、自動生成キャプションファイルはトランスクリプトの代わりにはなりません。
• 短いトランスクリプト段落、必要な場所での話者ラベル、手順段階やトピック変更の周辺の時間範囲を使用します。言い換えたスピーチから引用をでっち上げないでください。
• 解釈を変える可能性のある編集を明記します。証言、実験、またはデモンストレーションを、シーケンスが裏付けのない結果を暗示するように継ぎ接ぎしないでください。
• 必須の説明、価格、警告、資格条件、証拠、およびコールトゥアクションは録画の外に保持します。読者はタイムラインをスクラブして重大な事実を見つける必要があってはなりません。
• 自動再生、フラッシュコンテンツ、背景音声、コンバージョンオーバーレイ、ゲート付きトランスクリプトフィールド、または要素内の2つ目のプレーヤーを決して配置しないでください。
• メディア所有者とレビュートリガーを記録します。インターフェース、ポリシー、製品動作、話者の属性、または周辺の主張が変更されたときにビデオを再確認します。

これを使用する投稿タイプ

postTypesフロントマター配列がこのマトリックスを駆動します。包含は、時間ベースの証拠が意味を追加する場合にインラインビデオを許可します。すべてのページにプレーヤーを必須とするものではありません。

QAチェックリスト

• ビデオが、静止画像と簡潔な散文では同じように伝えられない時間ベースの意味を追加している。
• 可視タイトルが録画を具体的に示し、要約が再生前にその価値を説明している。
• 再生時間が読者がプレーヤーをアクティブにする前に表示される。
• ポスターが代表的で、判読可能で、承認済みであり、プライベートまたは誤解を招くコンテンツを含んでいない。
• 再生が自動的に開始されたり、予期せずループしたり、読者の操作なしに音声を発生させたりしない。
• 再生、一時停止、シーク、音量、速度、キャプション、全画面表示のコントロールがキーボードおよびタッチで動作する。
• キャプションが最終編集と一致し、名前、数字、話者の変更、意味のある音を正しく保存している。
• 音声で伝えられていない意味のある視覚情報に、音声説明または同等の代替バージョンが提供されている。
• 完全なトランスクリプトが選択可能なHTMLであり、録画の順序に従い、必要な視覚的アクションを説明している。
• 記述された手順、警告、条件、証拠、およびコールトゥアクションがビデオの外部でも利用可能である。
• 外部プロバイダーの読み込みが該当する同意ルールに従い、プロバイダーがアクティベーション前に特定されている。
• プレーヤー、ラベル、トランスクリプトが1つのセマンティックなfigureとして維持され、無関係なコンテンツによって中断されていない。
• 要素がテーブル、リスト、コールアウト、タブ、カルーセル、アコーディオンパネル、またはクリッカブルコンテナの中に入れ子になっていない。
• 録画とトランスクリプトが200%ズーム、狭い幅、動きの抑制、およびJavaScriptのみに依存しない意味で動作する。
• VideoObjectフィールドが可視で検証可能なメディアメタデータおよびアクセス可能な録画と一致している。
• 選択された投稿タイプがpostTypesに表示され、配置が上記のマトリックスと一致している。
• メディア所有者、権利、録画日、およびレビューまたは交換の条件が記録されている。

FAQ

すべてのインラインビデオにトランスクリプトは必要ですか？

はい。キャプションは同期再生に役立ち、トランスクリプトは読書、スキャン、検索、翻訳、引用、アクセシビリティ、抽出に役立ちます。音声が説明しない視覚的アクションを含む、完全な意味のあるコンテンツを含める必要があります。

ポスターフレームにビデオタイトルを含めてもよいですか？

はい。ただし、同じ識別情報がHTMLテキストにも表示される必要があります。ポスターテキストは小さな画面で判読できない場合があり、画像が失敗すると利用できず、ピクセルを解釈しないソフトウェアにはアクセスできません。

インラインビデオは自動再生すべきですか？

いいえ。自動再生はデータを消費し、読書を中断し、要求されていない動きや音声をもたらし、読者がいつ視聴するかを選択する権利を奪います。明示的なアクティベーション後にのみ開始してください。

キャプションとトランスクリプトは同じものですか？

いいえ。キャプションは再生にタイミングが合わされており、関連する音の手がかりを含みます。トランスクリプトは、録画の順序で構成され、意味のある視覚情報の必要な説明が補足された、永続的な読み取り代替手段です。

インラインビデオにVideoObjectスキーマは必要ですか？

いいえ。正確な可視メタデータと安定した録画がそれをサポートする場合にのみ、VideoObjectを追加します。信頼できる名前、説明、ポスター、アップロード日、再生時間、メディアURLのないプレーヤーは、不完全または捏造されたマークアップを生成すべきではありません。