本文にスキップする
Version: 5.5

ハードウェアビデオコーデックのサポート

LINE Planetは、1対1通話やグループ通話（カンファレンス）でユーザーのデバイス上でハードウェアビデオコーデックが有効または無効になるようにリクエストできます。

ここでは、ハードウェアビデオコーデックの有効または無効を設定し、その結果を確認する方法について説明します。

対応する通話タイプSDKの最低バージョン
1対1通話、グループ通話PlanetKit 3.2
Note

LINE Planet自体では、ハードウェアビデオコーデックをサポートするためのH.264コーデックを提供していません。ユーザーのデバイス上でH.264ハードウェアコーデックが利用可能であれば、LINE Planetはユーザーのデバイス上でH.264ハードウェアコーデックが有効になるようにリクエストします。詳しくは、LINE Planetの通話品質を参照してください。

ハードウェアビデオコーデックを有効または無効にする​

通話タイプによってハードウェアビデオコーデックを有効または無効にする方法について説明します。

Note

以下の理由により、必ずしもハードウェアビデオコーデックが有効になることを保証するものではありません。

  • 1対1通話で、ピアがハードウェアビデオコーデックを利用できない場合があります。
  • 運用上の問題により、LINE Planetチームがその機能を無効にする場合があります。

1対1通話​

1対1通話では、ハードウェアビデオコーデックを有効または無効にするために通話パラメーターを設定できます。

発信者側​

発信者側では、次のコードのように、通話を作成（make）する際にエンコード機能とデコード機能の両方がハードウェアビデオコーデックを有効または無効にするように設定します。

val myVideoSendCapability: PlanetKitVideoCapability = PlanetKitVideoCapability.callSendDefault()
val myVideoReceiveCapability: PlanetKitVideoCapability = PlanetKitVideoCapability.callReceiveDefault()

// For both callSendDefault() and callReceiveDefault(), the default value of preferredHwCodec is true.
// To request deactivation of hardware video codec, set both to false as follows:
// myVideoSendCapability.preferredHwCodec = false
// myVideoReceiveCapability.preferredHwCodec = false

val param = PlanetKitMakeCallParam.Builder()
            .myId(myUserId)
            .myServiceId(myServiceId)
            .peerId(peerUserId)
            .peerServiceId(peerServiceId)
            .myVideoSendCapability(myVideoSendCapability)
            .myVideoReceiveCapability(myVideoReceiveCapability)
            .build()

val result = PlanetKit.makeCall(param, makeCallListener)

受信者側​

受信者側では、次のコードのように、通話を受信（verify）する際にエンコード機能とデコード機能の両方がハードウェアビデオコーデックを有効または無効にするように設定します。

val myVideoSendCapability: PlanetKitVideoCapability = PlanetKitVideoCapability.callSendDefault()
val myVideoReceiveCapability: PlanetKitVideoCapability = PlanetKitVideoCapability.callReceiveDefault()

// For both callSendDefault() and callReceiveDefault(), the default value of preferredHwCodec is true.
// To request deactivation of hardware video codec, set both to false as follows:
// myVideoSendCapability.preferredHwCodec = false
// myVideoReceiveCapability.preferredHwCodec = false

val param = PlanetKitVerifyCallParam.Builder()
            .myId(myUserId)
            .myServiceId(myServiceId)
            .peerId(peerUserId)
            .peerServiceId(peerServiceId)
            .myVideoSendCapability(myVideoSendCapability)
            .myVideoReceiveCapability(myVideoReceiveCapability)
            .build()

val result = PlanetKit.verifyCall(param, verifyCallListener)

グループ通話​

グループ通話でハードウェアビデオコーデックを有効または無効にするには、次のコードのように、グループ通話に参加する際にエンコード機能とデコード機能の両方がハードウェアビデオコーデックを有効または無効にするように設定します。

val myVideoSendCapability: PlanetKitVideoCapability = PlanetKitVideoCapability.conferenceSendDefault()

// For conferenceSendDefault(), the default value of preferredHwCodec is true.
// To request deactivation of hardware video codec for encoding, set preferredHwCodec to false as follows:
// myVideoSendCapability.preferredHwCodec = false

// To enable or disable hardware video codec for decoding, set preferredPeerVideoHwCodec of PlanetKitConferenceParam to true or false.
val param = PlanetKitConferenceParam.Builder()
    .myId(myUserId)
    .myServiceId(myServiceId)
    .roomId(roomId)
    .roomServiceId(roomServiceId)
    .myVideoSendCapability(myVideoSendCapability)
    .preferredPeerVideoHwCodec(true)
    .build()

val result = PlanetKit.joinConference(param, conferenceListener)

ハードウェアビデオコーデックが有効または無効設定を確認する​

ハードウェアビデオコーデックの有効または無効設定の結果は、コールセットアップ（call setup）プロセスで決まります。したがって、onConnectedイベント発生後に結果を確認する必要があります。

  • 1対1通話では、onConnectedで渡したPlanetKitCallConnectedParamのisVideoHwCodecEnabledを使用してハードウェアコーデックが有効かどうかを確認できます。
  • グループ通話では、onConnectedで渡したisVideoHwCodecEnabledを使用してハードウェアコーデックが有効かどうかを確認できます。

関連API​

ハードウェアビデオコーデックのサポートに関連するAPIは次のとおりです。

1対1通話​

グループ通話​