용어
A
AEC (Acoustic echo canceller)
에코 제거 필터. 마이크에서 수집한 소리에서 에코만 제거하는 필터입니다.
AGC (Automatic gain controller)
음량 조절 필터. 입력되는 음성 크기를 일정한 레벨로 유지해 주는 필터입니다.
API key
LINE Planet API(PlanetKit API 및 LINE Planet Cloud API)를 호출하는 키. 애플리케이션이 LINE Planet을 연동하기 위해서는 API key가 필요합니다. API key 형태는 다음과 같습니다.
- 영문자(a-z, A-Z), 숫자(0-9), 붙임표(-) 및 밑줄(_)만 사용
- 최소 길이: 128 바이트
API secret
API key와 짝을 이루는 값. API key를 발급할 때 함께 발급됩니다. 발급받은 API secret은 노출되지 않도록 안전한 위치에 저장해야 합니다. API secret 형태는 다음과 같습니다.
- a부터 f까지의 영문 소문자와 숫자(0-9)만 사용
- 길이: 64 바이트
P
PlanetKit
LINE Planet 서버에 접근하게 해주는 클라이언트 SDK. LINE Planet을 연동한다는 것은 PlanetKit을 연동한다는 뜻입니다.
PlanetKit 통화 (PlanetKit call)
PlanetKit을 이용한 VoIP 통화. Wi-Fi 네트워크 또는 모바일 네트워크의 데이터를 사용합니다. 사용자가 가입한 데이터 요금제가 통화 품질에 영향을 미칠 수 있습니다.
S
SLA key
LINE Planet API(PlanetKit API 및 LINE Planet Cloud API)를 호출하기 위한 키. 이 역할은 API key로 대체됐으며 더 이상 SLA key를 사용하지 않습니다.
V
VPIO
음성 처리 IO. iOS/macOS에서 제공하는 VQE 모듈입니다.
VQE (Voice Quality Enhancement)
음성 품질을 향상해 주는 오디오 필터의 모음을 말합니다. 대표적인 모듈로는 AEC, NS, AGC가 있습니다.
ㅁ
모바일 통화 (Cellular call)
셀룰러 망을 통한 일반적인 통화
미팅 ID
PlanetKit를 연동한 애플리케이션으로 그룹 통화(컨퍼런스)를 할 수 있도록 숫자로 구분하는 방(room)의 식별자입니다. 사용자는 이 번호로 화상 회의 장비 같은 SIP 기기를 사용해 미팅에 참여할 수 있습니다.
ㅂ
발신자 (Caller, Initiator)
전화를 거는 터미널 디바이스 또는 최종 사용자.
방
그룹 통화를 하기 위한 가상의 장소
방 ID
그룹 통화(컨퍼런스) 인스턴스의 식별자. 다른 이들과 방 내에서 소통하려면 반드시 같은 방 ID를 사용해야 합니다. 방 ID 규칙은 사용자 ID와 같습니다.
ㅅ
사용자 ID
서비스 가입자의 식별자. 모든 사용자의 ID는 속한 서비스 내에서 유일해야 합니다. LINE Planet의 사용자 ID는 반드시 아래의 규칙을 따라야 합니다.
- 영문자(a-z, A-Z), 숫자(0-9), 붙임표(-) 및 밑줄(_)만 허용
- 최대 길이: 64 바이트
서비스 ID
서비스 식별자. LINE Planet은 이 식별자로 서비스를 구분합니다. 모든 애플리케이션은 아래와 같은 규칙으로 자신의 서비스 ID를 정의해야 합니다.
- 영문자(a-z, A-Z), 숫자(0-9), 붙임표(-) 및 밑줄(_)만 허용
- 최대 길이: 64 바이트
세션
통화 식별자.
셀룰러 망 (Cellular network)
모바일 네트워크. 2G, 3G, 4G, 5G 등을 말합니다.
ㅇ
애플리케이션 (Application)
LINE Planet Cloud를 이용하는 클라이언트 애플리케이션이나 서버 애플리케이션을 말합니다.
액세스 토큰 (Access token)
애플리케이션이 PlanetKit을 사용할 수 있게 해주는 단기 토큰
앱 서버 (App server)
LINE Planet 서버와 연결하는 서버 애플리케이션. 애플리케이션 개발팀이 앱 서버를 개발 및 유지보수합니다.
앱 클라이언트 (App client)
PlanetKit을 연동한 클라이언트 애플리케이션. 최종 사용자는 애플리케이션 개발팀이 만든 이 앱 클라이언트를 사용합니다.
오디오 품질
오디오 품질 수준은 표현 가능한 주파수 범위에 따라 다음과 같이 분류할 수 있습니다.
| 오디오 품질 | 표현 가능한 주파수 범위 |
|---|---|
| Narrowband(NB) | 4 kHz |
| High-definition(HD) | 8 kHz |
| High-definition+(HD+) | 12~16 kHz |
| Full high-definition(FHD) | 22.05~24 kHz |
이벤트와 이벤트 파라미터
이벤트(event)는 PlanetKit이 애플리케이션으로 보내는 알림을 의미합니다. 일반적으로 애플리케이션이 한 PlanetKit API를 호출하면 로컬과 원격이라는 2개의 이벤트가 발생합니다. 로컬 이벤트는 호출한 PlanetKit API의 결과를 보고하고, 원격 이벤트는 피어가 발생시킨 내용을 알려줍니다.
이벤트 파라미터는 이벤트가 발생했을 때 PlanetKit에서 생성한 데이터와 관련된 것입니다.
ㅊ
착신자 (Callee, Responder)
발신자의 카운터파트. 통화에서는 발신자가 착신자에게 전화를 걸게 됩니다.
참여자 (Participant)
그룹 통화(컨퍼런스)에 참여한 멤버