# Sora が期待どおりに動かない場合、または、動作に問題がある場合

Sora が期待どおりに動かない場合、
または動作に問題がある場合の問い合わせ時の事前確認と注意事項をまとめています。

## 事前確認

問い合わせの前に、まずは以下の項目について事前に確認をお願いします。

### 利用している Sora のバージョンが最新版か確認してください

**最新版でのみ、サポートの対応を行っております**

もし、最新版を利用していない場合は、最新版へのアップデート後に問題が再現するかの確認をお願いします。

### Sora の SDK サポートについては Sora サポート範囲外のため Discord サーバーの各チャンネルをご利用ください

**時雨堂コミュニティサーバー**: 

- Sora JS SDK- `#sora-js-sdk` チャンネル
- Sora iOS SDK- `#sora-ios-sdk` チャンネル
- Sora Android SDK- `#sora-android-sdk` チャンネル
- Sora Unity SDK- `#sora-unity-sdk` チャンネル
- Sora C++ SDK- `#sora-cpp-sdk` チャンネル
- Sora FlutterSDK- `#sora-flutter-sdk` チャンネル

### 利用しているブラウザが安定版の最新版か確認してください

ブラウザが古い場合、うまく接続できない可能性があります。

もし、ブラウザが古い場合は、最新版で再度問題が発生するかどうか確認をお願いします。

### 開発ツールを有効にして開発ツールで問題が再現するか確認してください

クライアント側の実装の問題もあるため、必ず確認をお願いしています。

もし、クライアント側の問題の場合は、 Sora のサポートでは対応することができません。ご了承下さい。

### クライアントのシグナリング接続が WebSocket over TLS で接続しているかどうかを確認してください

WebSocket over TLS ではない場合は、まずは WebSocket over TLS で接続するようにお願いいたします。

### Sora のサポート範囲外の質問はご遠慮ください

Sora の挙動や使い方以外はサポートの範囲外です。

- Sora を利用したサービスの設計や開発
- nginx 全般
- WebRTC 全般
- Sora SDK 全般
- WebRTC Native Client Momo
- WebRTC Load Testing Tool Zakuro
- Recording Composition Tool Hisui
- WebRTC Stats Collector Kohaku
- Audio Streaming Gateway Suzu
- 各種クラウドサービス

上記はすべて Sora のサポート範囲外となります。

## 問い合わせの場合、お送り頂く情報

> **重要**
>
> 前述の事前の確認後、以下の情報を **必ず** お送り下さい。

情報をお送り頂くときは `テキストファイル` でお送りください。

- サーバーやクライアントのスペック- わかれば機種名
  - CPU
  - メモリ
  - ディスク
- Linux Kernel のバージョン- `uname -a` の出力
- OS の種類、バージョン- Ubuntu、 Red Hat Enterprise Linux、CentOS のどれを使っているか
  - 使っているバージョン
- Sora のバージョン- 2021.1.2 など
- クラスターを利用している場合はクラスターの構成
- Sora の **sora.conf 設定ファイル**
- Sora の log ディレクトリ以下全てのログファイル- クラスターを利用している場合は全ノードのログ
  - tar.gz または zip などで圧縮し、パッケージ提供時にお送りしているログアップローダーを利用してお送りください
  - 評価中の場合は tar.gz または zip などで圧縮し、メールにてお送り下さい

### 詳細な問題発生状況

**何をどうすると問題が発生したのかの状況を可能な限り詳細にお教え下さい**

> **重要**
>
> 以下の情報については **必ず** お送り下さい。

- シグナリングの情報- チャネル ID
  - セッション ID
  - コネクション ID
  - 音声の有無- コーデック
    - ビットレート
  - 映像の有無- コーデック
    - ビットレート
    - 解像度
  - サイマルキャスト機能の有無
  - マルチストリーム機能の有無
  - スポットライト機能の有無
- 問題が発生したブラウザバージョン- Chrome 102.0.5005.61 や Safari 15.5 など
- SDK の種類とバージョン- Sora JavaScript SDK 2020.2.5 や Sora iOS SDK 2020.4.1 など
- 問題が発生したブラウザまたは SDK を利用している OS の種類とバージョン- iOS 14.4 や macOS 11.2.3 や Windows 10 1903 など
- 問題の発生状況- 発生時刻 (何度か発生している場合は複数)
  - 発生したタイミング (接続した直後、配信が10分以上継続した後、など)
  - 発生頻度
  - 発生時の配信者数、視聴者数
  - 発生の確率 (ある手順を踏むと必ず発生する、同じ手順でも5回に1回程度のみ発生する、など)

### 再現方法

**Sora 内蔵の開発ツールでの再現方法をお送りください**

- 再現の手順- 開発ツールで問題が発生する場合、その手順をお送り下さい- 接続する開発ツールの URL- 開発ツールの copy URL を押すと現在の設定を反映した URL がコピーされます
    - 複数クライアントを接続したときに発生する場合は、その順序と接続間隔 (ほぼ同時、数分おいて接続、など)
  - 開発ツールでは発生しない場合、開発ツールに準じた情報をお送り下さい- シグナリングのパラメータ
    - 複数クライアントの接続の場合、その順序と接続間隔 (ほぼ同時、数分おいて接続、など)
  - 問題を再現するための独立したアプリケーションが作成可能であれば、そちらをご用意頂くと解決までの距離が短くなります

## 録画関連の問い合わせについて

**録画については以下の点をご注意ください**

### 録画ファイルの取り扱いについて

もし、何か録画に問題があった場合でも、録画ファイルを送ることは **絶対** にしないでください。
録画したファイルの代わりに録画したファイルの情報を取得して送ってください。

録画ファイルの情報は mkvinfo と mediainfo コマンドを録画ファイルに対して実行した結果を、テキストファイルでお送りください。

mkvinfo は macOS で Homebrew を利用していれば `brew install mkvtoolnix` でインストール可能です。

それ以外は以下からダウンロードしてください。

[MKVToolNix news – Matroska tools for Linux/Unix and Windows](https://mkvtoolnix.download/)

mediainfo は macOS で Homebrew を利用していれば `brew install media-info` でインストール可能です。

それ以外は以下からダウンロードしてください。

[MediaInfo - Download](https://mediaarea.net/en/MediaInfo/Download)

mkvinfo コマンド例:

```
$ mkvinfo -t -z -v -v -v archive-K3FZ5EZJWS7HXBAJFR37ZYT4GR.webm
```

mediainfo コマンド例:

```
$ mediainfo --Details=2 archive-K3FZ5EZJWS7HXBAJFR37ZYT4GR.webm
```

### 問題が起きた状況について

- ブラウザで再生して問題が起きた場合は、ブラウザの種類とバージョン、プラットフォームをお教えください
- VLC で再生して問題が起きた場合は、VLC のバージョンとプラットフォームをお教えください

### HLS や MPEG-DASH の問い合わせについて

HLS や MEPG-DASH といった Sora が録画したファイルを変換した状態で発生した問題についてはサポート対象外です。