レンダリングビデオワークフロー
レンダリングは、コンポジションをフレームごとにキャプチャし、ビデオファイル(例:MP4)にエンコードするプロセスです。これは Node.js 環境で @helios-project/renderer パッケージを使用して行います。
クイックパス:1つのコマンド
npx -y @helios-project/cli@latest render composition.html -o output.mp4
- 再生時間、FPS、サイズはコンポジションの
window.heliosから取得されます。自分で設定するには、--duration、--fps、--width、--heightを渡します。 window.renderAt(t)で描画するページには--durationが必要です。--audio track.mp3でサウンドトラックを追加します。- プレーンな HTML ファイルはディスクから直接レンダリングされます。バンドラーでコンポジションをビルドする必要がある場合は、
npm run devを実行し、その URL を代わりに渡します。
以下のスクリプトは、入力プロパティ、複数のオーディオトラック、進行状況コールバックなどのカスタムパイプラインが必要な場合にのみ使用してください。
1. 前提条件
レンダラーにはコンポジションの URL が必要です:
- ディスク上のファイル:
file:///path/to/composition.html - 開発サーバー:
npm run dev、例http://localhost:3000/composition.html - その他アクセス可能な任意の URL
2. レンダースクリプトの作成
render.js(または ts-node を使用する場合は render.ts)という名前のファイルを作成します。
import { Renderer } from '@helios-project/renderer';
import path from 'path';
async function main() {
// 1. 設定
const compositionUrl = 'http://localhost:3000/composition.html';
const outputPath = path.resolve('output.mp4');
// 2. レンダラーの初期化
const renderer = new Renderer({
width: 1920,
height: 1080,
fps: 30,
durationInSeconds: 10,
// frameCount: 300, // オプション:durationInSeconds を正確なフレーム数で上書き
mode: 'canvas', // アニメーションが CSS/HTML 要素を使用する場合は 'dom' を使用
// オーディオ設定
audioTracks: [
{ path: 'background.mp3', volume: 0.5 },
{ path: 'voiceover.wav', offset: 2 }
],
audioCodec: 'aac',
// 入力プロパティ(動的コンテンツ)
inputProps: {
title: 'カスタムレンダー',
color: '#00ff00'
}
});
console.log(`レンダリング開始:${compositionUrl}...`);
// 3. レンダリングの実行
try {
await renderer.render(compositionUrl, outputPath, {
onProgress: (p) => {
const percent = Math.round(p * 100);
process.stdout.write(`\r進行状況:${percent}%`);
}
});
console.log(`\n完了! ${outputPath} に保存されました`);
} catch (err) {
console.error('\nレンダリング失敗:', err);
process.exit(1);
}
}
main();
3. レンダリングの実行
スクリプトを実行します。
# ts-node を使用する場合
npx ts-node render.ts
# node を使用する場合(コンパイル済み js)
node render.js
トラブルシューティング
「ページタイムアウト」または「接続拒否」
- コンポジションをホストしているローカルサーバーが実行中であることを確認してください。
- URL が正しく、通常のブラウザでアクセス可能か確認してください。
「黒い出力」または「空のビデオ」
window.heliosが公開されていること(またはページがwindow.renderAt(t)を定義していること)を確認してください。mode: 'canvas'を使用している場合、<canvas>要素に描画していることを確認してください。mode: 'dom'を使用している場合、要素が表示されていることを確認してください。
「レンダリングが停止する」
- コンポジションにブラウザコンソールにエラーがないか確認してください。
- トレースを有効にしてデバッグする:
await renderer.render(url, out, { tracePath: 'trace.zip' });
オーディオの問題
- オーディオファイルのパスがスクリプトの実行場所からの相対パスとして正しいことを確認してください。
mode: 'dom'を使用し、暗黙的なオーディオ(例:<audio>タグ)に依存している場合、要素が DOM に存在することを確認してください。