ブログ

日々の出来事

このエントリーはa-blog cms Advent Calendar 2025の21日目の記事です。

11月21日に開催された「a-blog cms Training Camp 2025」でご紹介させていただいた、弊社が開発している「SWIPE LP」テーマを制作する際に、アップロードした動画のposter画像を生成する方法を考えましたので、ご紹介させていただこうと思います。

「SWIPE LP」テーマとは


「SWIPE LP」テーマとはスマートフォンでの操作に最適化された、スワイプ形式のランディングページ用テンプレートです。1画面ずつ情報を見せる構成なので、ストーリーに沿ってスムーズに閲覧していただける点が特徴となります。離脱を抑えながら最後まで読み進めてもらいやすく、SNSのような操作感から若年層やスマートフォン利用が中心のユーザーと相性の良い形式です。

スマートフォンの場合は、真ん中のスライド部分が表示され、左右カラムの情報はメニューの中に格納されます。PCの場合は、真ん中の部分がスワイプ可能で、左右カラムの情報は固定で表示されます。

1枚のカード(コンテンツ)はエントリーで構成されており、動画・画像・ブロックエディタがレイヤー構造になっています。この様なエントリーを複数並べることで、LPページを構成する少し変わったテーマになります。

・「SWIPE LP」テーマ サンプルサイト
https://www.ideasource.jp/swipelp/

アップロードした動画からposter画像を生成する

では、早速ですが動画のカスタムフィールドの設定から、poster画像の生成まで、順番にご説明させていただきます。
最後にまとめたコードも一式掲載をしておきますので、ぜひチェックしてみてください。

エントリーの編集画面

動画用メディアカスタムフィールド、プレビュー用<video>タグ、poster用画像カスタムフィールドの設置

a-blog cmsの仕様では、メディアのカスタムフィールドに動画をアップロードすると、エントリー編集画面には「動画アイコン」が表示され動画自体は表示されませんが、今回の処理ではposter画像を生成するために動画自体を利用する必要がありますので、ファイルをアップロードするカスタムフィールドに加えて、動画のプレビューも設置が必要となります。

まずはエントリーの編集画面に必要な下記の3つ要素を追加します。
  • 動画アップロード用のカスタムフィールド(メディア)
  • 動画プレビュー用の<video>タグ
  • poster画像用のカスタムフィールド(画像)
操作の流れ
  1. 動画ファイルをメディアで登録しエントリーを保存します。
  2. 再度エントリーの編集画面を開くとプレビュー箇所に動画が表示されます。
  3. プレビュー動画の下にある「動画からポスター画像を生成」ボタンを押すと、jsの処理が動いてposter用の画像がカスタムフィールドの値に設定されます。(動画の1フレーム目をキャプチャして画像を生成します)
  4. その状態でエントリーを保存するとposter画像がカスタムフィールドに登録されます。



poster画像の生成は「動画からポスター画像を生成」ボタンをクリックすると、プレビュー用の動画からcanvas機能を使いpngファイルを生成します。



生成されたpngファイルは、そのままposter画像用のカスタムフィールドに値が設定されます。設定の処理が終わったら説明文言が切り替わりますので、その状態で「保存」をしてください。ちなみに生成されたposter画像は画面に表示させたくないため(プレビューと同じ画面なので)、cssで非表示にしています。



poster画像が設定されている状態で、エントリー編集画面を開くと「ポスター画像は登録されています。」に表示が切り替わります。この状態になっていたらエントリーの編集画面への実装は完了となります。poster画像を作り直したいときは、一度「ポスター画像を削除」にチェックを入れてエントリーを保存してから、再度エントリーの編集を行なってください。

エントリー編集画面のテンプレートの記述

エントリーのカスタムフィールドの設定とposter画像の設定をおこなっています。poster画像は軽量にするために横幅を200pxにしていますがお好みで変更してください。要素のIDなども自由に変えていただいてOKですが、jsと関連付いている所がありますのでご注意ください。また、jsをhtmlのテンプレートに直接記述する場合は「{}」にエスケープが必要な場合があります。ご利用のテンプレートに合わせて調整してください。

■ エントリー編集画面のカスタムフィールド

<table class="acms-admin-table-admin-edit cstm-admin-table-admin-edit">
	<tbody>
		<tr>
			<th>
				<span>動画</span>
			</th>
			<td>
				<div class="acms-admin-flex-column" id="swipelp-movwrapper">
					<div class="js-media-field" id="swipelp-moviewrapper">
						<div class="js-droparea" data-thumbnail="{swipelp_video@thumbnail}" data-type="file" data-thumbnail-type="{swipelp_video@type}" data-width="200px" data-height="200px"></div>
						<p class="js-text acms-admin-text-danger" style="display:none">許可されていないファイルのため挿入できません。</p>
						<div class="acms-admin-margin-top-mini">
							<button type="button" class="js-insert acms-admin-btn" data-type="file">メディアを選択</button>
						</div>
						<input type="hidden" name="swipelp_video" class="js-value" value="{swipelp_video}" />
						<input type="hidden" name="field[]" value="swipelp_video" />
						<input type="hidden" name="swipelp_video:extension" value="media" />
					</div>
				</div>

				<div class="acms-admin-flex-column cstm-movie-box">
					動画プレビュー<br>
					<video src="%{ARCHIVES_DIR}{swipelp_video@path}" controls
					mutedcontrolslist="nodownload"id="swipeli_video" class="acms-admin-img-responsive" width="200px"></video>
				</div>

				<div class="cstm-movie-box">
					ポスター画像は登録されています。<br>
					<div class="acms-admin-form-checkbox">
						<input type="checkbox" name="swipelp_video_image@edit" value="delete" id="input-checkbox-posterImg-delete" />
						<label for="input-checkbox-posterImg-delete">
							<i class="acms-admin-ico-checkbox"></i>
							ポスター画像を削除
						</label>
					</div>

					<img src="%{ARCHIVES_DIR}{swipelp_video_image@path}" class="js-img_resize_preview" alt="{swipelp_video_image@alt}" style="display:none" />
					<input type="hidden" name="swipelp_video_image@old" value="{swipelp_video_image@path}" />
				</div>
				<div class="cstm-movie-box">
					<a href="javascript:void(0);" onclick="generatePoster()" class="acms-admin-btn" style="width:200px;margin: 0.5em 0;padding:0.5em;">動画からポスター画像を生成</a><br>
					<div id="posterImageView">ポスター画像が登録されていません。<br>生成ボタンを押して画像を設定してください。</div>
					<div id="posterImageView-all" style="display:none">ポスター画像が設定されました。<br>エントリーを『保存』してください。</div>
				</div>
				<canvas id="canvas" style="display: none;"></canvas>
				<img id="posterImage" alt="Generated Poster" style="display: none; max-width: 200px;">
				<input type="file" name="swipelp_video_image" size="20" class="js-img_resize_input" id="swipelp_video_image_poster" style="display:none" />
				<input type="hidden" name="field[]" value="swipelp_video_image" />
				<input type="hidden" name="swipelp_video_image:extension" value="image" />
				<input type="hidden" name="swipelp_video_image@width" value="200" />
				<input type="hidden" name="swipelp_video_image@filename" value="" />
			</td>
		</tr>
	</tbody>
</table>

続いてjavascriptの処理になります。
こちらがプレビュー用の動画から、動画の1フレーム目をcanvasを利用してpngにし、画像のカスタムフィールドに値をセットする処理になります。
poster画像のカスタムフィールドの種類を、メディアではなく画像のカスタムフィールドにしている理由は、画像のカスタムフィールドではカスタムフィールドの<input>に値が設定されていれば、エントリー保存時に画像のアップロードが出来ますので、今回の様な処理の中でも簡単に実装が可能になります。

■エントリー編集画面のjavascript

<script>
const video = document.getElementById('swipeli_video');
const canvas = document.getElementById('canvas');
const ctx = canvas.getContext('2d');
const posterImage = document.getElementById('posterImage');
const hiddenInput = document.getElementById('swipelp_video_image_poster');
const posterImageView = document.getElementById("posterImageView");
const posterImageViewAll = document.getElementById("posterImageView-all");

function generatePoster() {
	// readyStateが1 (HAVE_METADATA) 未満の場合、メタデータが読み込まれていない
	if (video.readyState < HTMLMediaElement.HAVE_METADATA) {		
		// loadedmetadataイベントを一度だけ待ち、読み込み完了後にgeneratePosterを再実行
		video.addEventListener('loadedmetadata', generatePoster, { once: true });
		return;
	}
	
	// seekedイベントの二重登録を防ぐため、一度解除
	video.removeEventListener('seeked', onSeeked);
	
	// seekedイベント登録
	video.addEventListener('seeked', onSeeked, { once: true });
	
	// 1秒目にシーク
	video.currentTime = 1;
}

// seekedイベントの処理(修正版)
function onSeeked() {
	// 元の動画サイズ
	const originalWidth = video.videoWidth;
	const originalHeight = video.videoHeight;
	
	// 縮小後の幅を200pxに固定
	const targetWidth = 200;
	const scale = targetWidth / originalWidth;
	const targetHeight = originalHeight * scale;
	
	// キャンバスサイズを設定
	canvas.width = targetWidth;
	canvas.height = targetHeight;
	
	// 動画フレームを縮小して描画
	ctx.drawImage(video, 0, 0, targetWidth, targetHeight);
	
	// Blobとしてエクスポート(PNG形式)
	canvas.toBlob((blob) => {
		// Fileオブジェクトを作成(ファイル名を指定)
		const file = new File([blob], 'poster.png', { type: 'image/png' });
		
		// DataTransferを使用してFileListを作成
		const dataTransfer = new DataTransfer();
		dataTransfer.items.add(file);
		
		// input[type="file"]のfilesプロパティに設定
		hiddenInput.files = dataTransfer.files;
		
		// 変更イベントを発火
		hiddenInput.dispatchEvent(new Event('change', { bubbles: true }));
		
		// プレビュー表示(Blob URLを使用)
		const blobUrl = URL.createObjectURL(blob);
		posterImage.src = blobUrl;
		
		// メモリリーク防止
		setTimeout(() => URL.revokeObjectURL(blobUrl), 10000);
		
		// posterImage要素のスタイルを設定
		if (posterImageView) {
			posterImageView.style.display = "none";
		}
		
		// posterImage-all要素のスタイルを設定
		if (posterImageViewAll) {
			posterImageViewAll.style.display = "block";
		}
	}, 'image/png', 0.95);  // 品質を95%に設定
}
</script>

エントリーの表示画面

poster画像のパスは%{ARCHIVES_DIR}になります。動画ファイルに使っているメディア用の%{MEDIA_ARCHIVES_DIR}と間違えない様にしてください。poster画像の設定は、画像ファイルの設定がある場合のみ出力する様にしています。

■ エントリーの表示画面

<!-- BEGIN_IF [{swipelp_video@type}/eq/file] -->
	<video src="%{MEDIA_ARCHIVES_DIR}{swipelp_video@path}"<!-- BEGIN_IF [{swipelp_video_image@path}/nem] --> poster="%{ARCHIVES_DIR}{swipelp_video_image@path}"<!-- END_IF --> preload="none" class="acms-top-0 acms-left-0 acms-z-0" width="100%" height="100%" loop autoplay muted playsinline></video>
<!-- END_IF -->

まとめ

カスタムフィールドでアップロードした動画ファイルの1フレーム目から、poster画像を設定する方法を考えてみました。
動画はYouTubeにアップロードをする事で手間を省くことも多いですが、自サーバにアップする際にはposter画像のことも考えなくてはいけない場合があると思います。そんな時には、是非こちらの内容を参考にしていただけると幸いです。

今回も少し変わった内容だったかもしれませんが、実際の案件にも使えると思います。
今後もこの様なTIPSもご紹介させていただきますので、皆さまのa-blog cmsでのサイト制作に役立てていただければ幸いです。
では皆さま、良いクリスマスを、そして良いお年をお迎えください。


ブログの記事一覧