본문으로 건너뛰기
Version: 5.5

클라우드 통화 레코딩

LINE Planet은 요청에 따라 특정 1대1 통화를 클라우드에 레코딩하는 클라우드 통화 레코딩 기능을 제공합니다. 이 페이지에서는 PlanetKit을 통해 클라우드 통화 레코딩 기능을 사용하는 방법을 설명합니다.

지원 통화 유형최소 SDK 버전
1대1 통화5.2
Warning

클라우드 통화 레코딩 기능을 사용하려면 LINE Planet 팀과 사전 협의가 필요합니다. 이 기능을 사용하려면 LINE Planet 팀에 문의해 주세요.

클라우드 통화 레코딩 활성화​

발신자 또는 착신자는 콜 셋업(call setup) 과정 중에 클라우드 통화 레코딩을 활성화할 수 있습니다.

Tip

1대1 통화 셋업 흐름에 대해 자세히 알아보려면 1대1 통화 흐름을 참조하세요.

발신자 측​

발신자는 통화를 생성(make)할 때 클라우드 통화 레코딩을 활성화할 수 있습니다.

발신자 측에서 클라우드 통화 레코딩을 활성화하려면 MakeCallParam 객체에 SetRecordOnCloud(true)를 설정하고 이 MakeCallParam 객체를 인자로 MakeCall()을 호출하세요.

PlanetKit::PlanetKitCallPtr pPlanetKitCall;
PlanetKit::MakeCallParamPtr pMakeCallParam = PlanetKit::MakeCallParam::CreateWithAccessToken(
    myId, peerId, accessToken
);
pMakeCallParam->SetRecordOnCloud(true);

PlanetKit::PlanetKitManagerPtr pPlanetKitManager = PlanetKit::PlanetKitManager::GetInstance();
PlanetKit::SStartResult sStartResult = pPlanetKitManager->MakeCall(pMakeCallParam, &pPlanetKitCall);

착신자 측​

착신자는 통화에 응답(accept)할 때 클라우드 통화 레코딩을 활성화할 수 있습니다.

착신자 측에서 클라우드 통화 레코딩을 활성화하려면 AcceptCall() 호출 시 bRecordOnCloud에 true를 전달하세요.

// The `pPlanetKitCall` variable is the verified `PlanetKitCall` instance.

pPlanetKitCall->AcceptCall(bPreparation, pCallStartMessage, PLNK_INITIAL_MY_VIDEO_STATE_RESUME, true);

클라우드 통화 레코딩 관련 이벤트 수신​

클라우드 통화 레코딩 관련 이벤트를 수신할 수 있습니다. 이 이벤트는 레코딩 활성화 상태와 비활성화 사유 등의 정보를 전달합니다.

클라우드 통화 레코딩 상태가 업데이트되면 OnRecordOnCloudUpdated 콜백이 호출됩니다. 클라우드 통화 레코딩 상태와 관련된 정보를 얻으려면 OnRecordOnCloudUpdated 콜백의 pRecordOnCloud 파라미터에 다음 메서드를 사용하세요.

메서드반환 값 유형설명
IsActivated()bool클라우드 통화 레코딩 상태를 가져옵니다.
GetDeactivatedReason()DeactivateReasonOptional클라우드 통화 레코딩이 비활성화된 이유를 가져옵니다. 이는 다음 중 하나일 수 있습니다.
  • PLNK_RECORD_ON_CLOUD_DEACTIVATE_REASON_INTERNAL: 내부 오류가 발생했습니다.
  • PLNK_RECORD_ON_CLOUD_DEACTIVATE_REASON_ACTIVATION_FAILED: 클라우드에서 레코딩에 실패했습니다.
참고: IsActivated()의 반환 값이 true이면 반환 값은 nullptr가 될 수 있습니다.

관련 API​

클라우드 통화 레코딩과 관련된 API는 다음과 같습니다.