Trang này được dịch bởi Cloud Translation API.

Làm quen với Dịch vụ trò chơi của Play dành cho Android

Sau khi ngừng cung cấp API Đăng nhập bằng Google, chúng tôi sẽ xoá SDK games phiên bản 1 vào năm 2026. Sau tháng 2 năm 2025, bạn sẽ không thể xuất bản các trò chơi vừa tích hợp với SDK của games phiên bản 1 trên Google Play. Bạn nên sử dụng SDK của phiên bản 2.
Mặc dù các ứng dụng/trò chơi hiện có có tích hợp trò chơi phiên bản 1 trước đó vẫn tiếp tục hoạt động trong vài năm nữa, nhưng bạn nên di chuyển sang phiên bản 2 kể từ tháng 6 năm 2025.
Hướng dẫn này dành cho việc sử dụng SDK Dịch vụ trò chơi của Play phiên bản 1. Để biết thông tin về phiên bản SDK mới nhất, hãy xem tài liệu phiên bản 2.

Chào mừng bạn đến với hoạt động phát triển trò chơi Android bằng Dịch vụ Google Play Games!

SDK Play Games cung cấp Dịch vụ trò chơi của Google Play đa nền tảng, giúp bạn dễ dàng tích hợp các tính năng trò chơi phổ biến như thành tích, bảng xếp hạng và Trò chơi đã lưu vào trò chơi dành cho máy tính bảng và thiết bị di động.

Khoá đào tạo này sẽ hướng dẫn bạn cài đặt một ứng dụng trò chơi mẫu cho Android và nhanh chóng bắt đầu tạo trò chơi Android của riêng bạn. Ứng dụng mẫu Thử thách nhập số minh hoạ cách bạn có thể tích hợp thành tích và bảng xếp hạng vào trò chơi của mình.

Trước khi bắt đầu

Để chuẩn bị cho ứng dụng của bạn, hãy hoàn tất các bước trong những phần sau.

Điều kiện tiên quyết đối với ứng dụng

Hãy đảm bảo tệp bản dựng của ứng dụng sử dụng các giá trị sau:

Một minSdkVersion từ 19 trở lên
Một compileSdkVersion từ 28 trở lên

Thiết lập trò chơi của bạn trong Google Play Console.

Google Play Console là nơi bạn có thể quản lý các dịch vụ trò chơi của Google Play cho trò chơi của mình, đồng thời định cấu hình siêu dữ liệu để ủy quyền và xác thực trò chơi của bạn. Để biết thêm thông tin chi tiết, vui lòng xem phần Thiết lập Dịch vụ trò chơi của Google Play.

Định cấu hình ứng dụng

Trong tệp build.gradle cấp dự án, hãy thêm kho lưu trữ Maven của Google và kho lưu trữ trung tâm Maven vào cả hai mục buildscript và allprojects:

  buildscript {
    repositories {
      google()
      mavenCentral()
    }
  }

  allprojects {
    repositories {
      google()
      mavenCentral()
    }
  }

Thêm phần phụ thuộc Dịch vụ Google Play dành cho SDK Play Games vào tệp bản dựng Gradle của mô-đun, thường là app/build.gradle:

  dependencies {
    implementation 'com.google.android.gms:play-services-games:23.2.0'
  }

Hướng dẫn về ứng dụng mẫu

Bước 1: Tải ứng dụng mẫu xuống

Để xem hướng dẫn này dành cho nhà phát triển, bạn cần tải ứng dụng Android mẫu Type-a-Number Challenge xuống.

Cách tải xuống và thiết lập ứng dụng mẫu trong Android Studio:

Tải các mẫu Android xuống từ trang tải mẫu xuống.
Nhập dự án android-basic-samples. Dự án này bao gồm TypeANumber và các mẫu trò chơi Android khác. Cách thực hiện việc này trong Android Studio:
1. Nhấp vào File (Tệp) > Import Project (Nhập dự án).
2. Duyệt đến thư mục mà bạn đã tải android-basic-samples xuống trên máy phát triển. Chọn tệp android-basic-samples/build.gradle rồi nhấp vào OK.
Trong mô-đun TypeANumber, hãy mở AndroidManifest.xml và thay đổi tên gói từ com.google.example.games.tanc thành một tên gói khác của riêng bạn. Tên gói mới không được bắt đầu bằng com.google, com.example hoặc com.android.

Bước 2: Thiết lập trò chơi trong Google Play Console

Google Play Console là nơi bạn quản lý Dịch vụ trò chơi của Google Play cho trò chơi của mình, đồng thời định cấu hình siêu dữ liệu để uỷ quyền và xác thực trò chơi của bạn.

Cách thiết lập trò chơi mẫu trong Google Play Console:

Chuyển trình duyệt web của bạn đến Google Play Console rồi đăng nhập. Nếu chưa từng đăng ký Google Play Console, bạn sẽ được nhắc đăng ký.
Hãy làm theo các hướng dẫn này để thêm trò chơi vào Google Play Console.
1. Khi được hỏi liệu bạn có sử dụng API của Google trong ứng dụng của mình hay không, hãy chọn Tôi chưa sử dụng API nào của Google trong trò chơi của mình.
2. Để phục vụ mục đích của hướng dẫn dành cho nhà phát triển này, bạn có thể điền thông tin chi tiết về trò chơi của riêng mình vào biểu mẫu. Để thuận tiện, bạn có thể sử dụng các biểu tượng và ảnh chụp màn hình của phần giữ chỗ có trong trang Tải xuống.
Hãy làm theo các hướng dẫn này để tạo mã ứng dụng OAuth 2.0 cho ứng dụng Android của bạn.
1. Khi liên kết ứng dụng Android, hãy nhớ chỉ định chính xác tên gói mà bạn đã dùng trước đó khi đổi tên gói mẫu.
2. Bạn có thể dùng Trình hướng dẫn tạo APK đã ký trong Android Studio để tạo một kho khoá và chứng chỉ đã ký mới nếu chưa có. Để tìm hiểu cách chạy Trình hướng dẫn tạo APK đã ký, hãy xem phần Ký ứng dụng trong Android Studio.
Hãy nhớ ghi lại những thông tin sau để dùng sau:
1. Mã ứng dụng của bạn: Đây là một chuỗi chỉ bao gồm các chữ số (thường là 12 chữ số trở lên), nằm ở đầu mã ứng dụng.
2. Chứng chỉ ký của bạn: Lưu ý chứng chỉ bạn đã dùng khi thiết lập quyền truy cập API (chứng chỉ mà bạn đã cung cấp dấu vân tay SHA1). Bạn nên sử dụng cùng một chứng chỉ để ký ứng dụng khi kiểm thử hoặc phát hành ứng dụng.

Định cấu hình thành tích cho Thử thách nhập số:

Chọn thẻ Thành tích trong Google Play Console.

Thêm các thành tích mẫu sau:

Tên	Mô tả	Hướng dẫn đặc biệt
Dấu phẩy	Đạt được điểm số là một số nguyên tố.	None (Không có)
Humble	Yêu cầu điểm số là 0.	None (Không có)
Đừng kiêu ngạo, nhóc	Yêu cầu đạt điểm 9999 ở một trong hai chế độ.	None (Không có)
OMG U R TEH UBER LEET!	Nhận được điểm số 1337.	Đặt thành tích này là thành tích ẩn.
Buồn chán	Chơi trò chơi 10 lần.	Yêu cầu người chơi phải thực hiện nhiều bước để đạt thành tích này, với 10 bước để mở khoá.
Rất rất buồn chán	Chơi trò chơi 100 lần.	Yêu cầu người chơi phải thực hiện nhiều bước để đạt thành tích này, với 100 bước để mở khoá.

Ghi lại mã nhận dạng (chuỗi dài gồm chữ và số) cho từng thành tích mà bạn đã tạo.
Định cấu hình các thành tích phù hợp với trò chơi của bạn. Để tìm hiểu thêm, hãy xem các khái niệm đằng sau thành tích và cách triển khai thành tích trong Android.

Định cấu hình bảng xếp hạng cho Thử thách nhập số:
1. Chọn thẻ Bảng xếp hạng trong Google Play Console.
2. Thêm 2 bảng xếp hạng mẫu: một bảng có tên "Điểm cao dễ" và một bảng có tên "Điểm cao khó". Cả hai bảng xếp hạng đều phải sử dụng định dạng điểm Số nguyên với 0 chữ số thập phân và loại sắp xếp là Lớn hơn là tốt hơn.
3. Ghi lại mã nhận dạng (chuỗi dài gồm chữ và số) cho từng bảng xếp hạng mà bạn đã tạo.
4. Định cấu hình bảng xếp hạng phù hợp với trò chơi của bạn. Để tìm hiểu thêm, hãy xem các khái niệm đằng sau bảng xếp hạng và cách triển khai bảng xếp hạng trong Android.
Thêm tài khoản kiểm thử cho trò chơi của bạn. Bước này chỉ cần thiết đối với những ứng dụng chưa được xuất bản trong Google Play Console. Trước khi ứng dụng được xuất bản, chỉ những tài khoản kiểm thử có trong Google Play Console mới có thể đăng nhập. Tuy nhiên, sau khi ứng dụng được xuất bản, mọi người đều được phép đăng nhập.

Bước 3: Sửa đổi mã

Để chạy trò chơi, bạn cần định cấu hình mã nhận dạng ứng dụng dưới dạng một tài nguyên trong dự án Android của mình. Bạn cũng cần thêm siêu dữ liệu trò chơi vào AndroidManifest.xml.

Mở res/values/ids.xml rồi thay thế mã nhận dạng phần giữ chỗ. Nếu đang tạo một trò chơi Android từ đầu, trước tiên, bạn cần tạo tệp này.
1. Chỉ định mã ứng dụng của bạn trong tài nguyên app_id.
2. Chỉ định từng mã nhận dạng thành tích mà bạn đã tạo trước đó trong tài nguyên achievement_* tương ứng.
3. Chỉ định từng mã nhận dạng bảng xếp hạng mà bạn đã tạo trước đó trong tài nguyên leaderboard_* tương ứng.
Mở AndroidManifest.xml rồi nhập tên gói của bạn vào thuộc tính package của phần tử <manifest>. Nếu bạn đang tạo một trò chơi Android từ đầu, hãy nhớ thêm cả đoạn mã sau vào bên trong phần tử <application>:
```
<meta-data android:name="com.google.android.gms.games.APP_ID"
    android:value="@string/app_id" />
<meta-data android:name="com.google.android.gms.version"
   android:value="@integer/google_play_services_version"/>
```

Bước 4: Kiểm thử trò chơi

Để đảm bảo Dịch vụ trò chơi của Google Play đang hoạt động hiệu quả trong trò chơi, hãy thử nghiệm ứng dụng trước khi xuất bản ứng dụng đó trên Google Play.

Cách chạy trò chơi trên thiết bị kiểm thử thực:

Xác minh rằng bạn đã thiết lập tài khoản kiểm thử mà bạn đang dùng để đăng nhập vào ứng dụng (như mô tả trong Bước 2).
Xuất một APK và ký bằng chính chứng chỉ mà bạn đã dùng để thiết lập dự án trong Google Play Console. Để xuất một tệp APK đã ký trong Android Studio, hãy nhấp vào Build (Tạo) > Generate Signed APK (Tạo tệp APK đã ký).
Cài đặt APK đã ký trên thiết bị kiểm thử thực bằng công cụ adb. Để tìm hiểu cách cài đặt một ứng dụng, hãy xem phần Chạy trên thiết bị.