현지화

번역 생성

먼저, 번역 파일들이 저장될 i18n 폴더를 만드세요. 이 폴더에는 JSON 형식의 파일들이 들어갑니다. 이 파일들에 번역 내용이 저장됩니다.

예를 들어, 영어와 러시아어에 해당하는 en.jsonru.json 파일을 만들어보겠습니다.

이제 파일에 어떤 내용이든 채워 넣어야 합니다:

{
  "game": {
    "title": "Cool Game"
  },
  "button": "Button"
}
{
  "game": {
    "title": "Крутая игра"
  },
  "button": "Кнопка"
}

번역 가져오기

특정 키의 값을 가져오려면 i18n.localize(key) 메서드를 사용하면 됩니다.

print( i18n.key("game.title") ) -- "Cool Game"

또한 보조 메서드인 i18n.gui(node_id, key)가 있어, 사용자 인터페이스에서 선택한 노드의 내용을 교체할 수 있습니다.

i18n.gui()를 사용하면 다음과 같이 코드를 간소화할 수 있습니다:

gui.set_text(gui.get_node("Title Label"), i18n.key("game.title"))

이전:

i18n.gui("title_label", "game.title")

게임 현지화 예시

local i18n = require('ysdk.i18n')

local function on_localize()
    i18n.gui("title_label", "game.title")
    i18n.gui("button_label", "game.title")
end

function init(self)
    i18n.on(on_localize)
end

function final(self)
    i18n.off(on_localize)
end

언어 변경

참고

i18n 모듈은 환경 변수에 설정된 사용자의 언어에 맞게 언어를 자동으로 초기화합니다.

이 메서드는 사용자가 직접 언어를 변경하고자 할 때만 사용하는 것을 권장합니다.

번역 언어를 변경하려면 i18n.set_language(code: string) 메서드를 사용할 수 있습니다.

function settings.change_language(code)
    i18n.set_language(code)
end

저장소