Thành tích là một cách hay giúp tăng mức độ tương tác của người dùng trong trò chơi của bạn. Bạn có thể triển khai bảng thành tích trong trò chơi của mình để khuyến khích người chơi thử nghiệm các tính năng mà họ thường không sử dụng, hoặc tiếp cận trò chơi của bạn bằng những kiểu chơi hoàn toàn khác. Thành tích cũng có thể là cách thú vị giúp người chơi so sánh tiến trình của họ và tương tác cạnh tranh với những người chơi khác.
Để tìm hiểu cách triển khai bảng thành tích cho nền tảng của bạn, vui lòng xem phần Triển khai ứng dụng.
Thuộc tính
Để hiểu cách hoạt động của thành tích, bạn cần làm quen với một số thuộc tính liên kết với thành tích đó.
Những yếu tố cơ bản sau đây được liên kết với mọi bảng thành tích:
- Mã nhận dạng là một chuỗi duy nhất do Google Play Console tạo. Bạn sẽ sử dụng mã nhận dạng duy nhất này để tham chiếu đến thành tích trong ứng dụng trò chơi của mình.
- Tên là tên ngắn gọn của bảng thành tích (ví dụ: "Pieman"). Giá trị này có thể chứa tối đa 100 ký tự.
- Nội dung mô tả là phần mô tả ngắn gọn về thành tích của bạn. Thông thường, nội dung này sẽ hướng dẫn người chơi cách đạt được thành tích (chẳng hạn như "Làm bánh kem chanh trước khi mặt trời lặn"). Giá trị này có thể chứa tối đa 500 ký tự.
- Biểu tượng là một biểu tượng hình vuông liên kết với bảng thành tích của bạn. Để biết các phương pháp hay nhất khi tạo biểu tượng cho bảng thành tích, vui lòng xem phần Nguyên tắc về biểu tượng.
- Thứ tự danh sách là thứ tự xuất hiện bảng thành tích bị khoá khi người chơi xem bảng thành tích liên kết với trò chơi của bạn. Nó được sắp xếp theo thứ tự bất kỳ mà bạn muốn. Thành tích đã mở khoá sẽ xuất hiện ở đầu danh sách theo thứ tự đạt được.
Trạng thái
Có ba trạng thái khác nhau của các thành tích:
- Thành tích đã ẩn có nghĩa là thông tin chi tiết về thành tích bị ẩn với người chơi. Dịch vụ trò chơi của Play cung cấp một nội dung mô tả và biểu tượng trình giữ chỗ chung cho thành tích khi ở trạng thái ẩn. Bạn nên ẩn những thành tích nếu nó chứa một đoạn giới thiệu mà bạn không muốn tiết lộ quá sớm về trò chơi của mình (chẳng hạn như "Khám phá việc bạn là một ma !").
- Thành tích được tiết lộ có nghĩa là người chơi đã biết về thành tích đó nhưng chưa đạt được. Hầu hết các thành tích đều bắt đầu ở trạng thái được tiết lộ.
- Thành tích đã mở khoá có nghĩa là người chơi đã đạt được thành tích. Bạn có thể mở khóa thành tích mà không cần mạng. Khi bạn chơi trực tuyến, trò chơi sẽ đồng bộ hóa với Dịch vụ trò chơi của Play để cập nhật trạng thái đã mở khóa của thành tích.
Thành tích theo tiến trình
Thành tích có thể được chỉ định theo tiêu chuẩn hoặc tăng dần. Nói chung, thành tích gia tăng nghĩa là người chơi tiến bộ dần trong một thời gian dài để đạt được thành tích. Khi người chơi đạt được thành tích tăng dần, bạn có thể báo cáo tiến trình chơi của một người chơi cho Dịch vụ trò chơi của Play.
Dịch vụ Google Play theo dõi thông tin về tiến trình, các thông báo về trò chơi khi người chơi đáp ứng những tiêu chí cần thiết để đạt được thành tích đó, đồng thời báo cho người chơi biết họ đã đạt được mục tiêu bao xa.
Thành tích tăng dần được tích luỹ qua các phiên chơi, và bạn không thể xoá hoặc đặt lại tiến trình từ bên trong trò chơi. Ví dụ, "Thắng 50 ván" sẽ đủ điều kiện để đạt được thành tích tăng dần. "Thắng 3 ván liên tiếp" thì không được, vì tiến trình của người chơi sẽ được đặt lại cho mỗi lần thua. "Sở hữu 5.000 chip poker" cũng không đủ điều kiện, vì người chơi có thể thu thập và mất chip khi chơi. Đối với 2 thành tích nêu sau, bạn có thể tùy ý theo dõi trạng thái hoặc tổng số chip "Thắng trong một ván" của người chơi, và để mở khóa những thành tích tiêu chuẩn khi người chơi nhận được thành tích đó.
Khi tạo thành tích tăng dần, bạn phải xác định tổng số bước cần thiết để mở khóa thành tích (đây phải là một số có giá trị từ 2 đến 10.000). Khi người dùng tiến dần đến việc mở khoá thành tích, bạn nên báo cáo số bước bổ sung họ đã thực hiện cho Dịch vụ trò chơi của Play. Khi tổng số bước đạt đến giá trị mở khoá, thành tích sẽ được mở khoá (ngay cả khi nó bị ẩn). Bạn không cần phải lưu trữ tiến trình tích luỹ của người dùng.
Điểm
Các thành tích đều có một giá trị điểm liên kết với chúng. Điểm của người chơi phải là bội số của 5, và một trò chơi luôn có tổng số điểm không vượt quá 1000 cho toàn bộ thành tích (mặc dù trò chơi đó có thể có số điểm ít hơn). Ngoài ra, không có thành tích nào vượt quá 200 điểm.
Theo dõi điểm kinh nghiệm (XP)
Người chơi có thể nâng hạng trong Hồ sơ trò chơi của mình khi họ đạt được thành tích trong các trò chơi đã bật Play Games. Với mỗi điểm liên kết với một thành tích, người chơi sẽ nhận được 100 điểm kinh nghiệm (XP) khi đạt được thành tích đó. Hay nói cách khác:
XP for an achievement = 100 * (point value for the achievement)
Dịch vụ trò chơi của Play sẽ theo dõi XP mà người chơi kiếm được, sau đó gửi thông báo đến Ứng dụng Google Play Games khi người chơi đã tích đủ điểm để 'nâng hạng'. Người chơi có thể xem thứ hạng và lịch sử XP của họ trên trang Hồ sơ trong ứng dụng Google Play Games.
Thành tích tối thiểu
Một trò chơi tích hợp thành tích cần có ít nhất 5 thành tích trước khi phát hành. Bạn có thể thử nghiệm với ít hơn 5 thành tích, nhưng bạn nên tạo ít nhất 5 thành tích trước khi phát hành trò chơi.
Thành tích tối đa
Số thành tích được hạn định bởi việc phân bổ và các giới hạn về điểm số. Với số điểm tối đa là 1.000, và mỗi thành tích được chỉ định 5 điểm, thì số thành tích tối đa sẽ là 200. Tuy nhiên, nếu thành tích được chỉ định nhiều điểm hơn, thì số thành tích hiện có sẽ giảm xuống.
Thêm thành tích
Có hai cách để tạo thành tích lần đầu tiên bằng Google Play Console:
- Tạo thành tích: Thêm định nghĩa và siêu dữ liệu cho từng thành tích.
- Nhập thành tích: Nhập định nghĩa và siêu dữ liệu khác cho nhiều thành tích cùng một lúc.
Tạo thành tích
Để tạo một thành tích cho trò chơi mới và chưa phát hành, hãy hoàn thành các bước sau:
- Trong Google Play Console, hãy chọn một trò chơi.
- Trên trang Dịch vụ trò chơi của Play – Thành tích (Phát triển > Dịch vụ trò chơi của Play > Thiết lập và quản lý > Thành tích), hãy chọn Tạo thành tích.
- Trên trang Thêm thành tích, hãy điền thông tin vào biểu mẫu.
- Nhấp vào Lưu dưới dạng bản nháp.
- Sau khi tạo thành tích, bạn cần phát hành trò chơi.
Thêm thành tích khác
Nếu bạn đã có các thành tích hiện có và muốn thêm thành tích khác:
- Trong Google Play Console, hãy chọn một trò chơi.
- Trên trang Dịch vụ trò chơi của Play – Thành tích (Phát triển > Dịch vụ trò chơi của Play > Thiết lập và quản lý > Thành tích), hãy chọn Thêm thành tích.
Nhập thành tích
Để thêm nhiều thành tích vào trò chơi cùng một lúc, hãy làm theo các bước sau:
- Tạo một tệp zip chứa các thành tích của bạn.
- Tải tệp lên.
Để biết thêm thông tin về tệp zip, hãy xem Nguyên tắc về tệp zip.
Cách nhập thành tích:
- Trong Google Play Console, hãy chọn một trò chơi.
- Trên trang Dịch vụ trò chơi của Play – Thành tích (Phát triển > Dịch vụ trò chơi của Play > Thiết lập và quản lý > Thành tích), hãy chọn Nhập thành tích.
- Trên trang Nhập thành tích, hãy nhấp vào Tải lên.
- Chọn tệp zip để tải lên.
- Nhấp vào Lưu dưới dạng bản nháp.
- Sau khi nhập thành tích, bạn cần phát hành trò chơi.
Xuất bản trò chơi của bạn
Sau khi bạn thử nghiệm và phát hành trò chơi, tất cả thành tích của trò chơi sẽ được phát hành cùng với trò chơi đó.
Chỉnh sửa thành tích
Để chỉnh sửa bảng thành tích bạn đã tạo, hãy chọn bảng thành tích đó trong thẻ Thành tích của Google Play Console. Tại đây, bạn sẽ thấy biểu mẫu đã từng dùng khi tạo bảng thành tích lần đầu, và bạn có thể chỉnh sửa bất kỳ trường nào theo nhu cầu.
Khi bạn chỉnh sửa xong bảng thành tích, hãy nhấp vào nút Lưu dưới dạng bản nháp. Bảng thành tích mới được chỉnh sửa sẽ ở giai đoạn "sẵn sàng để thử nghiệm", và bạn đã có thể thử nghiệm nó. Nếu bảng thành tích hoạt động như mong đợi, hãy chọn mục Tái phát hành từ danh sách thả xuống. Thao tác này sẽ thực hiện việc phát hành lại trò chơi của bạn, cùng với tất cả các thành tích đã được cập nhật công khai.
Hủy nội dung chỉnh sửa
Nếu bạn không hài lòng với bảng thành tích hiện có và muốn quay lại bản cũ, hãy chọn nút Huỷ bỏ từ danh sách thả xuống trong Google Play Console, tất cả các bảng thành tích của bạn sẽ quay về phiên bản đã phát hành trước đó.
Xóa thành tích
Một khi đã phát hành, bạn không thể xóa các bảng thành tích đó.
Bạn chỉ có thể xoá một bảng thành tích ở trạng thái trước khi phát hành bằng cách nhấp vào nút có nhãn Xoá ở cuối biểu mẫu của thành tích đó.
Đặt lại thành tích
Bạn chỉ có thể đặt lại dữ liệu tiến trình của người chơi cho các bảng thành tích nháp mà thôi.
- Để đặt lại thành tích trong Google Play Console, hãy nhấp vào nút có nhãn Đặt lại tiến trình thành tích ở cuối biểu mẫu của sự kiện đó.
- Để đặt lại dữ liệu thành tích theo phương thức lập trình, hãy gọi các phương thức
Achievementscủa API Quản lý.
Hướng dẫn về biểu tượng
Biểu tượng phải được tạo dưới dạng tệp PNG, JPEG hoặc JPG có tỷ lệ 512 x 512. Bạn chỉ cần cung cấp cho chúng tôi biểu tượng của thành tích đã mở khoá. Chúng tôi sẽ tự động tạo một phiên bản thang màu xám cho biểu tượng đã được công khai. Do đó, bạn nên sử dụng biểu tượng mang tính màu sắc để người dùng có thể dễ dàng phân biệt giữa các thành tích đã mở khoá và được công khai.
Khi một biểu tượng thành tích xuất hiện trong thông báo nhanh trên Android, biểu tượng đó sẽ có lớp phủ vòng tròn và các góc bên ngoài bị ẩn. Hãy đảm bảo biểu tượng của bạn vẫn bắt mắt trong những lần xuất hiện như thế.
Tất cả các ngôn ngữ đều sử dụng cùng một biểu tượng, do đó bạn nên tránh thêm bất kỳ nội dung hoặc văn bản nào đã được bản địa hoá vào một biểu tượng.
Nguyên tắc về tệp ZIP
Bạn có thể nhập nhiều thành tích cùng lúc bằng tệp zip. Hãy tham khảo bảng để biết tên tệp chính xác cần sử dụng trong tệp zip:
| Tên tệp | Bắt buộc hoặc không bắt buộc | Giá trị được chấp nhận |
|---|---|---|
AchievementsMetadata.csv
|
Bắt buộc | Siêu dữ liệu cho từng thành tích. Xem phần Thuộc tính. |
AchievementsLocalizations.csv
|
Không bắt buộc | Cung cấp bản dịch cho tên và nội dung mô tả thành tích. |
AchievementsIconMappings.csv
|
Không bắt buộc | Liên kết thành tích với tệp biểu tượng của thành tích đó. |
| Tệp biểu tượng | Không bắt buộc | Biểu tượng ở định dạng PNG, JPEG hoặc JPG. |
Yêu cầu đối với tệp ZIP:
- Không có thư mục con.
- Tên tệp duy nhất.
- Chỉ tệp CSV, PNG, JPEG hoặc JPG.
- Tệp CSV không được có hàng tiêu đề.
- Mỗi tệp phải có kích thước dưới 1 MB.
- Tệp zip không được chứa quá 203 tệp.
- Tổng kích thước tệp ZIP phải dưới 200 MB.
Định dạng AchievementsMetadata.csv
Tệp AchievementsMetadata.csv chứa siêu dữ liệu cho từng thành tích.
Tệp này phải bao gồm thông tin dưới dạng các giá trị được phân tách bằng dấu phẩy theo thứ tự sau:
Name,Description,Incremental value,Steps Needed,Initial State,Points,List Order
Các trường này được mô tả trong bảng sau:
| Tiêu đề cột CSV | Bắt buộc hoặc không bắt buộc | Giá trị được chấp nhận |
|---|---|---|
| Tên | Bắt buộc | Tối đa 100 ký tự |
| Mô tả | Không bắt buộc | Tối đa 500 ký tự |
| Giá trị gia tăng | Không bắt buộc | True hoặc False
|
| Các bước cần thực hiện | Bắt buộc nếu Incremental Value là True.
|
Số (không có phân số hoặc số thập phân) |
| Trạng thái ban đầu | Bắt buộc | Hidden hoặc Revealed
|
| Điểm | Bắt buộc | Số chia hết cho 5 và giá trị phải nằm trong khoảng từ 5 đến 200 |
| Thứ tự trong danh sách | Không bắt buộc | Số (không có phân số hoặc số thập phân và lớn hơn 0) |
Yêu cầu về tệp AchievementsMetadata.csv:
- Mỗi hàng phải có 7 giá trị. Nếu bạn muốn bỏ qua một giá trị, hãy để trống giá trị đó.
- Các trường
NamevàDescriptionđược dùng làm ngôn ngữ mặc định. - Trường
Namephải khác nhau trên tất cả các thành tích. - Các trường sau đây không được chứa dấu phẩy:
NamevàDescription.
Tệp AchievementsMetadata.csv mẫu:
Achievement1,Achievement One,True,100,Hidden,5,20
Achievement2,Achievement Two,False,,Revealed,10,30
Định dạng AchievementsLocalizations.csv
Tệp AchievementsLocalizations.csv là một tệp không bắt buộc, thiết lập tất cả dữ liệu cần thiết để mô tả từng thành tích cho người dùng ở nhiều ngôn ngữ.
Bảng thành tích được dịch cho phù hợp với ngôn ngữ được chỉ định cho trò chơi.
Tệp này phải bao gồm thông tin dưới dạng các giá trị được phân tách bằng dấu phẩy theo thứ tự sau:
Name, Localized name, Localized description, locale
Các trường này được mô tả trong bảng sau:
| Tiêu đề cột CSV | Bắt buộc hoặc không bắt buộc | Mô tả | Giá trị được chấp nhận |
|---|---|---|---|
| Tên | Bắt buộc | Phải khớp với cột Name từ AchievementsMetadata.csv.
|
Tối đa 100 ký tự |
| Tên được bản địa hoá | Bắt buộc | Tên đã bản địa hoá của thành tích. | Tối đa 100 ký tự |
| Nội dung mô tả đã bản địa hoá | Không bắt buộc | Nội dung mô tả đã bản địa hoá cho thành tích theo ngôn ngữ đã chỉ định. | Tối đa 500 ký tự |
| Ngôn ngữ | Bắt buộc | Mã ngôn ngữ, chẳng hạn như en-US.
|
Thêm bản dịch cho trò chơi trước khi chỉ định ngôn ngữ. Xin lưu ý rằng bạn không thể chỉ định ngôn ngữ mặc định.
Bạn có thể tìm thấy mã ngôn ngữ được hỗ trợ trong danh sách ngôn ngữ được hỗ trợ. |
Yêu cầu về tệp AchievementsLocalizations.csv:
- Tên thành tích trong một trò chơi phải là duy nhất cho từng ngôn ngữ. Ví dụ: nếu một trò chơi hỗ trợ cả ngôn ngữ en-US và fr-FR, thì thành tích có tên "Achievement1" cho en-US cũng có thể được đặt tên là "Achievement1" cho fr-FR.
- Mỗi hàng phải có 4 giá trị. Nếu bạn muốn bỏ qua giá trị Nội dung mô tả được bản địa hoá, hãy để trống giá trị này.
Tệp AchievementsLocalizations.csv mẫu:
Achievement1,Achievement One,This is the description of achievement one in English.,en-US
Achievement1,Achievement Un,Voici la description de l'achievement un en français.,fr-FR
Achievement2,Achievement Two,Description of achievement two.,en-US
Achievement2,Logro Dos,Descripción del logro dos.,es-ES
Achievement3,Achievement Three,,en-US
Achievement3,Erfolg Drei,,de-DE
Định dạng AchievementsIconMappings.csv
Tệp AchievementsIconMappings.csv là tệp không bắt buộc dùng để liên kết thành tích của bạn với biểu tượng đã cho. Tệp này phải bao gồm thông tin dưới dạng các giá trị được phân tách bằng dấu phẩy theo thứ tự sau:
Name, icon filename
Các trường này được mô tả trong bảng sau:
| Tiêu đề cột CSV | Bắt buộc hoặc không bắt buộc | Mô tả |
|---|---|---|
| Tên | Bắt buộc | Phải khớp với cột Name từ AchievementsMetadata.csv.
|
| Tên tệp biểu tượng | Bắt buộc | Tên tệp biểu tượng. |
Yêu cầu về tệp AchievementsIconMappings.csv:
- Mỗi hàng phải có hai giá trị.
- Tệp biểu tượng chỉ có thể ở định dạng PNG hoặc JPEG.
TệpAchievementsIconMappings.csv mẫu:
Valid Achievement,valid-achievement-icon.png
Incremental Achievement,incremental-achievement-icon.jpeg
No Description,no-description-icon.png
Hidden Initial State,hidden-initial-state-icon.png
Large Point Value,large-point-value-icon.jpeg
Tệp biểu tượng
Các biểu tượng mà bạn tham chiếu trong tệp AchievementsIconMappings.csv phải tồn tại trong tệp lưu trữ zip hiện tại mà bạn nhập. Để biết thêm thông tin, hãy xem bài viết Nguyên tắc về biểu tượng.
Thêm bản dịch cho các thành tích
Bạn có thể chỉ định bản dịch riêng cho các bảng thành tích liên kết với trò chơi của mình. Trước khi làm như vậy, đầu tiên bạn phải nhớ hoàn thành các bước như mô tả trong nội dung bài viết Thêm bản dịch cho trò chơi của bạn.
Bạn có thể thêm bản dịch cho trò chơi theo hai cách:
Bạn có thể sử dụng tuỳ chọn nhập thành tích để tải bản dịch lên cho nhiều thành tích mới cùng một lúc. Bạn không thể sử dụng tuỳ chọn này để tải bản dịch lên cho các thành tích đã có.
Bạn có thể thêm bản dịch cho từng bảng thành tích trong trò chơi. Cách thêm bản dịch riêng cho từng thành tích:
- Trong Google Play Console, hãy mở thẻ Thành tích của trò chơi, sau đó chọn một thành tích hiện có.
- Trên trang chi tiết về bảng thành tích, hãy chọn thẻ cho ngôn ngữ mà bạn đã thêm trước đó ở thẻ Thông tin trò chơi.
- Trên trang chi tiết bảng thành tích của ngôn ngữ đó, hãy chỉnh sửa biểu mẫu có bản dịch cho bảng thành tích đó.
- Nhấp vào Lưu để lưu trữ thông tin chi tiết bản dịch của bảng thành tích.
Triển khai ứng dụng
Để tìm hiểu cách triển khai bảng thành tích cho nền tảng của bạn, vui lòng xem các tài nguyên sau: