# セッションリプレイ動画が見れない、うまく再生されない場合

### セッションリプレイ取得状況の確認 <a href="#replay-status-check" id="replay-status-check"></a>

2025年11月の機能追加により、セッションリプレイが取得できなかった場合の理由がユーザータイムライン上で確認できるようになりました。

<table><thead><tr><th width="140.796875">表示項目</th><th>原因と対処法</th></tr></thead><tbody><tr><td><strong>データなし</strong></td><td>Limit超過やクライアントサイドの通信エラー等でデータ保存処理が行われなかった。通信環境を確認してください。</td></tr><tr><td><strong>時間が短すぎます</strong></td><td>操作時間が10秒未満のため、動画データが生成されませんでした。これは正常な動作です。</td></tr><tr><td><strong>保存エラー</strong></td><td>通信環境等の問題によりデータ欠損が発生しました。継続して発生する場合はサポートにお問い合わせください。</td></tr></tbody></table>

## 再生できないデータが多い <a href="#id-1-3" id="id-1-3"></a>

クライアントサイドの通信状況等による散発的なエラーに以下の様な傾向が見える場合

* 全てのセッションで再生ボタンが表示されない
  * タグ設置が正常に行われていない
  * 他ツールのタグやサイトの実装との関連で根本的な部分で処理エラーが発生している
* 特定のユーザーで再生ボタンが表示されない
  * 何らかの通信ブロックツール等で処理が中断されている
* 特定のページで再生ボタンが表示されない
  * ページのHTMLが不正等の理由でそのページでのみ処理エラーが発生している
* 上記傾向は分からないがエラーは多いと感じる
  * HTMLサイズが非常に大きい等、通信が不安定になりやすい特性がある

何らかの傾向やエラーの多さを感じる場合は原因調査により解決できるケースもあるため、サポートまでご連絡ください。

## 再生できるが表示が正しくない <a href="#display-issues" id="display-issues"></a>

### スタイル崩れが起きている <a href="#style-issues" id="style-issues"></a>

再生時に、記録された当時に配信されたCSSへのアクセスを行います。

その為、当時のCSSファイルが変更されていたり、存在しない場合はスタイル情報を正しく再現できず表示が崩れる場合があります。(imgタグの画像なども同様です)

この問題に対処する為、CSSルールのキャプチャリングを自動的に行なっていますが1ファイルあたりのCSSルール数が多すぎる場合や3rd partyのCDNから配信されている場合などキャプチャリングが無効になります。

解決策として下記の様な方法が考えられます。

* 1CSSファイルあたりのルール数を分割し減少させる（目安は最大3,000ルール程度）
* サーバー側で古いCSSファイルも保持し続けるように処理を変更する

### スタイル崩れが起きている(CSS in JSを使用している場合) <a href="#css-in-js-issues" id="css-in-js-issues"></a>

[styled-components](https://styled-components.com/)等代表的なCSS in JSライブラリについてはサポートしていますが、全てを網羅はできていません。CSS in JSライブラリをご利用されていてプレイヤー上で正常にCSSが適用されない場合はサポートまでご連絡ください。

## サポート外のHTMLタグ <a href="#unsupported-tags" id="unsupported-tags"></a>

iframe, embed, object, canvas タグについてはサポートしていません。

動画は再生可能ですが、該当箇所が空白になるなど正しく表示されない場合があります。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.wicle.io/other/troubleshoot/troubleshooting-sessionreplay.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.