統計情報¶

用語¶

統計情報取得方法¶

統計情報の取得には getStats を利用します。

以下に getStats を使った統計情報取得の実装例を示します。

import android.util.Log
import androidx.fragment.app.Fragment
import androidx.lifecycle.lifecycleScope
import jp.shiguredo.sora.sdk.channel.SoraMediaChannel
import kotlinx.coroutines.launch
import org.webrtc.RTCStatsReport

// SoraMediaChannel インスタンスが mediaChannel 変数に代入されていることを前提とします。
private var mediaChannel: SoraMediaChannel? = null

// WebRTC 統計情報のうち codec 情報をログに書き込む関数です。
suspend fun dumpCodecStats() {
    // getStats で WebRTC 統計情報を取得します。
    val report: RTCStatsReport = mediaChannel?.getStats() ?: return

    // statsMap の型は Map<String, org.webrtc.RTCStats> です。
    report.statsMap.forEach { (key, stats) ->

        // codec かどうかの判定には RTCStats.type を使います。
        if (stats.type == "codec") {
            // RTCStats.members の型は Map<String, Object> です。
            // members のキーは RTCStats オブジェクトの種類ごとに違います。
            // 以下の例では codec の持つメンバーを抽出しています。
            val payloadType = stats.members["payloadType"]
            val mimeType = stats.members["mimeType"]
            val transportId = stats.members["transportId"]
            Log.d("Stats", "WebRTC Stats Codec Type: $key, Payload Type: $payloadType, Mime Type: $mimeType, Transport Id: $transportId")
        }
    }
}

// suspend fun を Fragment から呼び出す例です。
fun Fragment.requestCodecStats() {
    // SoraMediaChannel.getStats は suspend のためコルーチンスコープから実行する必要があります。
    viewLifecycleOwner.lifecycleScope.launch {
        dumpCodecStats()
    }
}

上記 getStats のコード例に出てきた内容について以下で解説します。