Translation

The translation library is provided by leveraging Google's Cloud Translation function.
Google's translation API KEY is required to use this library, so if you have not received one
Please proceed by following the guide document below.

If you have already received an API KEY, you can proceed to next paragraph.

Register API KEY

This function is partially free, but in order to use the translation function, you must first obtain an API KEY to use Google Translate.

---

Register your account information

First, log in to Google and go to the place that issues the API (opens new window).
After that, click Try Translation for Free and you will be redirected to the page.

• Click the ‘Try Translation for Free’ button above to enter.

• Enter the required information as above and click Next to proceed.

• Enter the required information as above and click Use Free Trial at the end.

• Account information registration is complete.

TIP

Card registration is not automatically charged, and you may be charged a $1 fee for initial registration, but will be refunded.
If you don't sign up for automatic billing yourself, you won't be charged additionally when you use up your API quota.

---

Get an API key

1. Press the menu button on the left to bring up the sidebar. Click the Marketplace displayed here to move.
2. After that, type translation in the search bar to search.

3. Click Cloud Translation API in the search results to go to it.

4. Click the Use button displayed on the moved page and move on.

5. Click User Credentials after being moved.

6. After pressing + Create user authentication information displayed in the middle right corner, press the ‘API key’ button that appears to receive an API KEY.

---

Registering API KEY to vchatcloud CMS

1. Go to the room where you want to use the translation API from the Dashboard or Chat Room Management-Chat Room List of CMS.
2. Change Google Translate to Use, enter the API key you received earlier in the input box to the right of Google API KEY shown below, and click the Certification button on the right.

3. If you entered normally, you will receive a notification saying Authenticated as shown in the image above.
4. Click the Modified button on the right to save.

라이브러리 사용 방법

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

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

String a_user = "en";

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());
  }
});

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

...

@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());   // 스크롤 이동 이벤트
}

...

JSONObject 리턴 데이터

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