Skip to main content
Version: 6.0

Hardware video codec support

For a 1-to-1 call or a group call (conference), LINE Planet can request activation or deactivation of a hardware video codec on the user device.

This page shows how to configure settings to enable or disable a hardware video codec and how to check the result.

Supported call typeMinimum SDK version
1-to-1 call, group call3.1.13
Note

LINE Planet itself does not provide an H.264 codec in order to support hardware video codec. Instead, if an H.264 hardware codec is available on the user device, LINE Planet requests activation of the H.264 hardware codec on the user device. For more information, see LINE Planet call quality.

Configure settings to enable or disable a hardware video codec​

This section describes how to configure settings to enable or disable a hardware video codec.

Note
  • The activation of hardware video codec is not always guaranteed, due to the following reasons:
    • In a 1-to-1 call, a hardware video codec might not be available to the peer.
    • The LINE Planet team can turn off the function due to operational issues.
  • Prior to PlanetKit 6.0, the hardware video codec settings were configured through the call parameter when making/verifying a 1-to-1 call or joining a group call. Starting with PlanetKit 6.0, however, the hardware video codec settings are configured through PlanetKitManager instead of setting them for each 1-to-1 call or group call individually.

After initializing the SDK, configure the hardware video codec settings using SetPreferredHardwareCodec().

void YourApplication::InitializePlanetkit()
{
    PlanetKit::ELogLevel eLogLevel = PlanetKit::PLNK_LOG_SIMPLE;
    PlanetKit::ELogSizeLimit eLogSizeLimit = PlanetKit::PLNK_LOG_SIZE_LIMIT_SMALL;

    PlanetKit::ConfigurationPtr pConfiguration = PlanetKit::Configuration::Create(L"./", L"./");
    pConfiguration->SetLogLevel(eLogLevel);
    pConfiguration->SetLogSizeLimit(eLogSizeLimit);
    pConfiguration->EnableLogOutput(true);

    PlanetKit::PlanetKitManager::Initialize(pConfiguration);

    PlanetKit::PlanetKitManagerPtr pPlanetKitManager = PlanetKit::PlanetKitManager::GetInstance();

    pPlanetKitManager->UpdateServerUrl(planet_base_url);

    // Create preferred hardware codec settings
    PlanetKit::SPreferredHardwareCodec preferredHardwareCodec = PlanetKit::SPreferredHardwareCodec{/* set fields */};
    // Configure the preferred hardware codec settings
    pPlanetKitManager->SetPreferredHardwareCodec(preferredHardwareCodec);
}

Check whether a hardware video codec is enabled or disabled​

The result of enabling or disabling a hardware video codec is determined during a call setup process. Therefore, you must check the result after the OnConnected event occurs.

  • In 1-to-1 calls, you can check whether a hardware codec is enabled or disabled using IsVideoSendHardwareCodecEnabled() of the CallConnectedParam delivered by OnConnected.
  • In group calls, you can check whether a hardware codec is enabled or disabled using IsVideoSendHardwareCodecEnabled() of the ConferenceConnectedParam delivered by OnConnected.

APIs related to hardware video codec support are as follows.