ビデオ

HTML アプリ内メッセージでビデオを再生するには、HTML に次の <video> 要素を含め、動画名を実際のファイル名 (またはリモートアセットの URL) に置き換えます。他の可能な<video>オプションはMDN Web Docsで見つけることができます。

1
2
3
4
5
<video class="video" autoplay muted playsinline controls>
  <source src="https://video-provider.com/YOUR_VIDEO_FILE.mp4" type="video/mp4">
  <source src="https://video-provider.com/YOUR_VIDEO_FILE.ogg" type="video/ogg">
  Your device does not support playing this video.
</video>

ローカル動画アセットを使用するには、アセットをキャンペーンにアップロードする際にこのファイルを含めるようにしてください。

Androidに関する考慮事項

Android 上の HTML アプリ内メッセージに動画およびその他の HTML5 コンテンツを埋め込むには、アプリ内メッセージが表示されるアクティビティでハードウェアアクセラレーションを有効にする必要があります。詳細については、Android開発者ガイドを参照してください。

自動再生ハードウェアアクセラレーションのイネーブルメントを有効にしている場合でも、Android WebViewではメディア再生を開始するためにユーザーの操作が必要になることがある。自動再生が必要な場合、アプリ内メッセージのHTMLレンダリングに使用するWebViewの設定でWebSettings.setMediaPlaybackRequiresUserGesture(false)、ユーザー操作の要求を無効にする必要がある。これは、アプリ内メッセージのHTML表示方法をSDKレベルでカスタマイズする必要がある。設定の手順については、Braze SDKのアプリ内メッセージのカスタマイズを参照せよ。

iOSの考慮事項

iOS デバイスをサポートするには:

• フルスクリーン再生はサポートされていないため、このplaysinline属性を必ず含めなければならない。
• iOSでは自動再生は保証されない。iOSの再生動作はOSレベルWKWebViewでのメディアポリシーに依存し、[muted設定]と[設定]autoplayが有効な場合でもユーザー操作が必要となる場合がある。対象のiOSバージョンとデバイスで、アプリ内メッセージのHTMLをテストせよ。

自動再生が必要な場合で、テストによりデフォルトでは機能しないことが判明したときは、HTMLアプリ内メッセージで使用されるWKWebViewConfiguration をカスタマイズできる。例えば のmediaTypesRequiringUserActionForPlaybackプロパティを設定することで、メディア再生におけるユーザーアクション要件を調整できる。これはSDKレベルのカスタマイズが必要だ。Swiftのリソースについては、Braze SDKのアプリ内メッセージのカスタマイズと、Swift向けWebViewへのBraze JavaScriptインターフェイスの追加を参照のこと。

Web上の考慮事項

ほとんどの現代のブラウザは、特定の条件下でのみ自動再生を許可している（一般的に動画がミュートされている場合である）。ウェブアプリ内メッセージautoplayで を使用する場合、 を含めmuted、サポート対象のブラウザとデバイスでテストすること。ブラウザのポリシーは異なり、場合によってはユーザーの操作を依然として必要とする可能性があるためだ。