テクニカルライターのための画面収録ガイド

静的なスクリーンショットと長いテキストには限界があります。ユーザーは長い段落をスキップし、注釈を誤解し、番号付きリストに埋もれた重要な手順を見落とします。画面収録は、あいまいさなく、順序通りに何をすべきかを正確に示すことで、こうした問題を解決します。

このガイドでは、テクニカルライターがRecordedを使用して、サポート負荷を軽減し製品の採用を改善するドキュメントグレードの動画を作成する方法を解説します。

技術ドキュメントに動画が必要な理由

テキストベースのドキュメントは参照資料（APIリファレンス、設定オプション、概念説明など）に向いています。しかし、手順コンテンツ（Xはどうやるの？）では、動画の方が速く理解でき、誤解しにくい場合がほとんどです。

テクニカルライターにとっての主なメリット：

• あいまいさの軽減: 視聴者が説明された近似値ではなく、正確なUI状態を確認できる
• サポート量の削減: 動画に従えるユーザーは同じタスクでチケットを開くことがほぼない
• 迅速なオンボーディング: 新規ユーザーがガイドなしで複雑なワークフローを学習できる
• 言語の壁を超える: 上手に作られた動画は翻訳されたテキストよりも言語の壁を超えやすい

収録セッションの計画

優れたドキュメント動画は、収録ボタンを押す前から始まります。

まず手順をスクリプト化する

番号付き手順のように全手順を書き出してください。これが収録スクリプトになります。手順が書きにくい場合は、収録も難しいでしょう。それをアプローチを簡略化するサインとして活用してください。

適切なキャプチャモードを選ぶ

• ウィンドウキャプチャ: ほとんどのドキュメント作業に使用します。デスクトップの雑然さからアプリケーションを分離し、クリーンで集中した画面を提供します。
• フルスクリーン: 複数のアプリケーションやシステムレベルの操作間のコンテキストを示す必要がある場合に適しています。
• カスタム領域: より大きなアプリケーション内の特定のパネルやウィジェットをキャプチャするのに便利です。

何を話し、何を見せるかを決める

すべてにナレーションが必要なわけではありません。一部の操作は画面上で自明です。なぜのコンテキストを追加するナレーションを計画し、動画がどのようにを示すようにしてください。

ドキュメント用の収録設定

ドキュメントクオリティの収録には以下の設定を使用してください：

• 解像度: ネイティブディスプレイ解像度でキャプチャします。必要に応じてエクスポート時にダウンスケールしてください。
• フレームレート: 30fpsが理想的です。ファイルサイズを増やさずにUIインタラクションに十分なめらかです。
• カーソルの可視性: 常にカーソルを表示してください。視聴者がどこをクリックしているか追跡する必要があります。
• システムオーディオ: 関連がなければ無効にしてください。通知音や背景音はナレーションの妨げになります。

効果的なキャプチャ

複雑な操作ではゆっくりと動く

特にドラッグ＆ドロップ、キーボードショートカット、コンテキストメニューなどの複数ステップの操作を行う際は、カーソルを意識的に動かしてください。収録中に遅く感じることが、再生時には自然に見えます。

重要な操作前に一時停止する

各重要な操作前に0.5秒の一時停止を入れると、何かが変わる前に視聴者が現在地を把握する時間が生まれます。目に見えるUIキューがないキーボードショートカットには特に効果的です。

集中するためにウィンドウキャプチャを使う

アプリケーションウィンドウだけをキャプチャすることで、ドキュメントをクリーンに保てます。視聴者がデスクトップ、他の開いているウィンドウ、ブラウザタブに気を散らされません。

ドキュメント用の編集

積極的にトリミングする

ドキュメント動画はできるだけ短くあるべきです。以下を削除してください：

• UIが応答を待つ長い一時停止
• 関連する領域から離れる瞬間
• 操作を繰り返し試みた箇所

小さなUI要素にズーム効果を追加する

多くのドキュメントシナリオには、小さなボタン、アイコン、テキストフィールドが含まれます。Recordedのズーム効果を使用して、操作の瞬間に視聴者を引き込み、結果を示すためにズームアウトしてください。

ドキュメント用ズームのベストプラクティス：

• クリック後ではなく前にズームイン
• 視聴者がラベルやテキストを読めるだけ十分長くズームを維持
• 操作の全体的な結果を示すために通常の表示に戻る

カーソルハイライトを使用する

クリックポイントを明確にするためにカーソルハイライトを有効にしてください。クリック時の視覚的なパルスは、何が選択されたかの疑念を取り除きます。これは密集したインターフェースの操作に特に有用です。

各動画を1つのタスクに集中させる

複数の手順を1つの長い動画に組み合わせる誘惑に負けないでください。短くタスク中心の動画は、見つけやすく、共有しやすく、製品UIが変更されたときに管理しやすいです。

ドキュメントへの動画の統合

動画と書かれた手順をペアにする

動画とテキストは互いを補完します。スキャンを好むユーザーのために、ドキュメントに書かれた手順を保持してください。視聴を好むユーザーのために、手順のすぐ上または下に動画を埋め込んでください。

わかりやすいファイル名とタイトルを使用する

特定のタスクを反映するように動画ファイル名と埋め込みタイトルを付けてください：tutorial-video-3.mp4ではなくcreate-api-key.mp4のように。これによりドキュメントライブラリを規模に合わせて維持管理できます。

ドキュメントサイト用のエクスポート形式

ドキュメントプラットフォーム（Confluence、Notion、GitBook、ReadMe）への埋め込み用：

• MP4（H.264）: プラットフォームとブラウザ全体で最高の互換性
• 解像度: コンテンツの密度に応じて1280×720または1920×1080
• ファイルサイズ: できるだけ動画1本あたり50MB未満に抑える — 大きなファイルはページ読み込みを遅くする

動画ライブラリの構築

ソースファイルとともに全ドキュメント動画の構造化されたフォルダを維持してください。製品がUI変更を出荷する際に、古くなったコンテンツを特定して再録画しやすくなります。

メンテナンス：動画を最新の状態に保つ

ドキュメント動画には寿命があります。UIの更新は書かれたコンテンツよりも速く動画を無効化します。これを軽減するために：

• 主要なUIリリースで再録画: 変更されたナビゲーションや再設計された画面を示す動画を優先
• 動画の説明に「最終確認」日付を追加: コンテンツがどれほど最新かをユーザーに示す
• 録画を短く保つ: 短い動画は長いウォークスルーより再録画のコストが低い

ドキュメント動画チェックリスト

ドキュメント収録を公開する前に：

• 全手順が明確に順序通りに表示されている
• 常にカーソルが表示されている
• 小さいまたは重要なUI要素にズーム効果が適用されている
• 不必要な一時停止が削除されている
• オーディオが明確で背景ノイズがない
• 動画の長さがタスクが許す限り短い
• 適切な解像度でMP4形式でエクスポートされている
• ドキュメントで書かれた手順と動画がペアになっている

まとめ

画面収録はテクニカルライターのツールキットの中で最も活用されていないツールの1つです。よく書かれた手順と一緒に使用すると、あいまいさを軽減し、ユーザーの自信を向上させ、対象とするタスクのサポート量を削減します。

最もよく寄せられるサポート問い合わせから始めてください。ユーザーが最も頻繁に提起する問題こそ、明確で集中した録画が最大の効果をもたらす場所です。