# 번역 이용하기

번역 기능은 Google의 Cloud Translation 기능을 활용하여 제공되며 해당 기능은 부분 무료이나, 번역 기능을 사용하기 위해서는 먼저 구글 번역을 사용하기 위한 API KEY를 발급받아야 합니다.

해당 기능을 사용하기 위해서 Google의 번역 API KEY가 필요하니 발급받으신 적이 없으시다면 아래 가이드 문서를 따라 진행하시기 바랍니다.
만약 이미 API KEY를 발급 받았고, 알고 있는 상태라면 VChatCloud CMS에 API KEY 등록하기부터 진행하시면 됩니다.

# 계정 정보 등록하기

먼저 Google에 로그인 하시고 API를 발급해주는 곳 (opens new window)로 이동합니다.
그 후 Translation 무료로 사용해 보기를 클릭하시면 페이지가 이동됩니다.

TIP

카드 등록 시 자동 청구되지 않으며, 처음 등록 시 1달러가 청구될 수 있으나 다시 환불 처리됩니다.
직접 자동 청구를 신청하지 않으면 API 할당량을 모두 사용해도 추가 청구되지 않습니다.

# API 키 발급받기

# VChatCloud CMS에 API KEY 등록하기

# 라이브러리 사용 방법

라이브러리 사용 방법은 아래와 같습니다.

번역을 하기 위해 타겟팅 언어를 설정해야 합니다.

String a_user = "en";

1
2

번역할 언어를 서버로 전송합니다.

String roomId = Constant.ROOM_ID; // API가 적용되어진 roomID
String text = "번역할 메시지"; // 화면에 표시하기 전 메시지
VChatCloudApi.getInstance().translate(text, a_user, roomId, new ApiCallback() {
  @Override
  public void onFailure(VChatCloudException e) {
    Log.d("번역", "실패");
  }

  @Override
  public void onSuccess(JSONObject jsonObject) {
    Log.d("성공", jsonObject.toJSONString());
  }
});

1
2
3
4
5
6
7
8
9
10
11
12
13

번역되어진 내용을 화면에 적용 합니다.

...

@Override
public void onSuccess(JSONObject jsonObject) {
  Log.d("성공", jsonObject.toJSONString());
  message.setMessage((String) jsonObject.get("data"));        // 번역되어진 메시지로 변경
  $MessageList.add(message);                                  // 메시지 리스트에 적용
  changedHandler.sendMessage(changedHandler.obtainMessage()); // 데이터 변경 이벤트
  scrollHandler.sendMessage(scrollHandler.obtainMessage());   // 스크롤 이동 이벤트
}

...

1
2
3
4
5
6
7
8
9
10
11
12
13

JSONObject 리턴 데이터

값	식별자	설명
result_msg	String	실패 시 사유
result_cd	int	성공 (1), 실패(0)
data	String	번역되어진 텍스트

← OVERVIEW 파일 공유 →