Địa phương hóa

Trình chỉnh sửa bản địa hóa

Các bản dịch được lưu dưới định dạng tệp JSON trong dự án và chúng tôi khuyến nghị sử dụng định dạng này để chỉnh sửa.

Sau khi cài đặt plugin, hãy chọn mục Localization Editor trong phần SDK của Yandex Games.

Ban đầu, trình chỉnh sửa sẽ khá trống rỗng. Đó là vì bạn cần tạo bản địa hóa đầu tiên của mình, điều này có thể thực hiện bằng cách nhấn nút Create ở góc trên bên trái.

Một cửa sổ modal sẽ xuất hiện trước bạn, cho phép bạn chọn ngôn ngữ. Sau khi hoàn tất, nhấn Create JSON file.

Ví dụ, chọn English (en) và nhập nội dung sau vào trình chỉnh sửa.

{
  "title": "best game in the world 2"
}

Nhấn vào nút Save để lưu bản địa hóa của bạn và kiểm tra nó trong trò chơi.

Áp dụng bản địa hóa của bạn

Bản địa hóa có thể được áp dụng bằng hai cách: thông qua phương thức l10n.t() hoặc thông qua thành phần bản địa hóa thông minh.

Phương thức l10n.t

Hãy thử sử dụng phương thức l10n.t() trước tiên. Tạo một thành phần mới và chèn vào đó đoạn sau:

import { _decorator, Component, Label } from "cc";
import { l10n } from "db://yandex-games-sdk/ysdk";
const { ccclass, requireComponent } = _decorator;

@ccclass("ButtonLocalizationTest") // Tên của component.
@requireComponent(Label) // Phụ thuộc vào component Label.
export class ButtonLocalizationTest extends Component {
  onLoad() {
    const label = this.getComponent(Label); // Lấy component Label.
    label.string = l10n.t("title"); // Cài đặt chuỗi cho Label dựa trên khóa đã được định trước.
  }
}

Sau khi bạn tạo một node với component Label trên scene, bạn có thể định vị hóa nó bằng cách kéo component vào node.

Component L10nLabel có sẵn

Nếu bạn không muốn phát minh lại bánh xe, plugin có component sẵn sàng hiển thị khóa trực tiếp trong trình soạn thảo. Không cần biên dịch dự án để xem thay đổi vì nó sẽ tự động cập nhật khi có thay đổi trong trình soạn thảo dịch thuật.

Nhấp vào nút Add Component cho node bạn quan tâm, cuộn đến nhóm YandexGamesSDK và chọn L10nLabel.

Bây giờ bạn có thể nhập khóa của mình vào trường Key và tận hưởng kết quả. Bất kể bạn thay đổi ngôn ngữ như thế nào, các thay đổi sẽ lập tức được hiển thị ở đây.