통화 시작 메시지
1대1 통화에서 발신자와 착신자는 콜 셋업 과정 중에 제한된 크기의 메시지를 서로에게 보낼 수 있습니다. 이 메시지를 통화 시작 메시지(call start message)라고 합니다.
| 지원 통화 유형 | 최소 SDK 버전 |
|---|---|
| 1대1 통화 | 모든 버전 |
통화 시작 메시지는 PlanetKit 5.0.x 이하에서 제공되는 "Call Init 데이터"와 기능적으로 동일합니다. PlanetKit 5.1부터 기능의 이름만 변경되었습니다.
통화 시작 메시지 보내기
발신자와 착신자는 콜 셋업 과정 중 서로 다른 시점에 통화 시작 메시지를 보낼 수 있습니다.
콜 셋업 흐름에 관해 좀 더 자세히 알고 싶으면 1대1 통화 흐름을 참고하세요.
발신자 측
발신자는 통화를 생성(make)할 때 통화 시작 메시지를 보낼 수 있습니다.
발신자 측에서 통화 시작 메시지를 보내려면 CallStartMessage를 만들고 CallStartMessage를 MakeCallParam에 설정한 다음 MakeCall()을 호출할 때 MakeCallParam을 전달하세요.
PlanetKit::CallStartMessagePtr pCallStartMessage;
pCallStartMessage = PlanetKit::CallStartMessage::Create(L"Call start message from a caller");
PlanetKit::PlanetKitCallPtr pPlanetKitCall;
PlanetKit::MakeCallParamPtr pMakeCallParam = PlanetKit::MakeCallParam::CreateWithAccessToken(
myId, peerId, accessToken
);
pMakeCallParam->SetCallStartMessage(pCallStartMessage);
PlanetKit::PlanetKitManagerPtr pPlanetKitManager = PlanetKit::PlanetKitManager::GetInstance();
auto pMic = pPlanetKitManager->GetAudioManager()->GetCurrentMic();
PlanetKit::SStartResult sStartResult = pPlanetKitManager->MakeCall(pMakeCallParam, pMic, &pPlanetKitCall);
통화 시작 메시지는 OnVerified 콜백을 통해 착신자에게 전달됩니다.
착신자 측
착신자는 통화에 응답(accept)할 때 통화 시작 메시지를 보낼 수 있습니다.
착신자 측에서 통화 시작 메시지를 보내려면 CallStartMessage를 생성하고 AcceptCall() 호출 시 CallStartMessage를 전달하세요.
PlanetKit::CallStartMessagePtr pCallStartMessage;
pCallStartMessage = PlanetKit::CallStartMessage::Create(L"Call start message from a callee");
// The `pPlanetKitCall` variable is the verified `PlanetKitCall` instance.
pPlanetKitCall->AcceptCall(bPreparation, pCallStartMessage);
통화 시작 메시지는 OnConnected 콜백을 통해 발신자에게 전달됩니다.
크기 제한
통화 시작 메시지의 최대 크기는 null 종료 문자를 포함하여 200바이트입니다.
통화 시작 메시지와 앱 서버 데이터 비교
통화 시작 메시지와 앱 서버 데이터는 다음과 같은 차이점이 있습니다.
| 발신지와 목적지 | 지원 통화 유형 | |
|---|---|---|
| 통화 시작 메시지 | 발신자의 앱 클라이언트 → 착신자의 앱 클라이언트 착신자의 앱 클라이언트 → 발신자의 앱 클라이언트 | 1대1 통화 |
| 앱 서버 데이터 | 발신자 또는 참여자의 앱 클라이언트 → 앱 서버 | 1대1 통화, 그룹 통화(컨퍼런스) |
관련 API
통화 시작 메시지 기능과 관련된 API는 다음과 같습니다.