Làm quen với Dịch vụ trò chơi của Play dành cho C++ trên 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. SDK C++ cho Dịch vụ trò chơi của Play phiên bản 2 hiện chưa có.

Hướng dẫn dành cho nhà phát triển này sẽ hướng dẫn bạn cách biên dịch và chạy một trò chơi C++ trên Android bằng API Dịch vụ trò chơi của Google Play. Trước khi bắt đầu, hãy tải xuống và định cấu hình các yêu cầu sau:

Hướng dẫn dành cho nhà phát triển này sử dụng Bộ phát triển gốc (NDK) của Android. Nếu bạn chưa quen với NDK, hãy tham khảo tài liệu và các mẫu NDK trước khi tiếp tục.

Bước 1: Thiết lập môi trường

  1. Tải SDK Android và NDK Android xuống rồi giải nén vào máy của bạn. Trong môi trường của bạn, hãy đặt SDK_ROOT thành vị trí của thư mục SDK Android và NDK_ROOT thành vị trí của thư mục NDK Android.
  2. Tải các trò chơi mẫu C++ xuống. Hướng dẫn dành cho nhà phát triển này đề cập đến vị trí của các mẫu trên máy của bạn là SAMPLES_DIR.
  3. Tải SDK C++ của dịch vụ Google Play Games xuống. Giải nén SDK vào máy phát triển của bạn. Trong môi trường của bạn, hãy đặt biến NDK_MODULE_PATH để trỏ đến thư mục phía trên thư mục gpg-cpp-sdk. Bạn phải có cấu trúc thư mục sau: 
    NDK_MODULE_PATH/
gpg-cpp-sdk/
  4. Mở Eclipse. Nếu bạn chưa thực hiện việc này, hãy cho Eclipse biết nơi bạn đã cài đặt NDK bằng cách nhấp vào Preferences > Android > NDK (Lựa chọn ưu tiên > Android > NDK).

  5. Nhập dự án thư viện Dịch vụ Google Play vào không gian làm việc Eclipse.

    1. Trong Eclipse, hãy nhấp vào File > Import > Android > Existing Android Code into Workspace (Tệp > Nhập > Android > Mã Android hiện có vào không gian làm việc).
    2. Chọn SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib, trong đó SDK_ROOT là vị trí của SDK Android.
    3. Nhấp vào Hoàn tất.

  6. Nhập dự án mẫu tối giản vào không gian làm việc Eclipse.

    1. Trong Eclipse, hãy nhấp vào File > Import > Android > Existing Android Code into Workspace (Tệp > Nhập > Android > Mã Android hiện có vào không gian làm việc).
    2. Chọn SAMPLES_DIR/samples-android/minimalist.
    3. Nhấp vào Hoàn tất.

  7. Nhấp chuột phải vào dự án MinimalistActivity rồi nhấp vào Properties (Thuộc tính). Trong phần Android, hãy di chuyển xuống phần Thư viện và đảm bảo dự án google-play-services_lib được tham chiếu đúng cách. Nếu không, hãy xoá tệp đối chiếu rồi thêm lại tệp đó trong không gian làm việc của bạn.

Eclipse sẽ tự động biên dịch các nguồn Java và Android của dự án; tuy nhiên, mã gốc trong thư mục jni cần được biên dịch riêng. Để thực hiện việc này theo cách thủ công, hãy chuyển đến thư mục jni rồi chạy ndk-build. Hãy nhớ thực hiện việc này sau khi bạn thực hiện bất kỳ thay đổi nào trong thư mục jni.

Dự án của bạn hiện sẽ biên dịch, mặc dù chưa hoạt động. Trước tiên, bạn phải định cấu hình trò chơi của mình trong Google Play Console.

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

Tạo một mục nhập cho trò chơi của bạn trong Google Play Console. Thao tác này sẽ bật Dịch vụ trò chơi cho ứng dụng của bạn và tạo mã ứng dụng khách OAuth 2.0 (nếu bạn chưa có).

  1. Tạo một mục nhập cho trò chơi của bạn bằng cách làm theo các bước được mô tả trong phần Thiết lập Dịch vụ trò chơi của Google Play.
  2. Trong AndroidManifest.xml, hãy thay đổi thuộc tính package của thẻ <manifest> thành tên gói bạn đã chọn khi thiết lập Google Play Console. Bạn có thể phải sửa một số tham chiếu trong dự án sau khi thực hiện thay đổi này (đặc biệt là đối với lớp R đã tạo).
  3. Mở res/values/ids.xml rồi đặt Mã ứng dụng của bạn vào đó. Xin lưu ý rằng mã ứng dụng không giống với mã ứng dụng khách; đó là số bên cạnh tên trò chơi của bạn trong trang Thông tin chi tiết về trò chơi của Google Play Console.

Bước 3: Chạy mẫu

Để chạy mẫu này, bạn sẽ cần một thiết bị Android thực hoặc một trình mô phỏng đã cài đặt Dịch vụ Google Play:

  1. Chạy ndk-build để biên dịch mã gốc.
  2. Trong Eclipse, hãy nhấp vào Run > Run As > Android Application (Chạy > Chạy dưới dạng > Ứng dụng Android) rồi chạy mẫu trên thiết bị của bạn.
  3. Khi mẫu mở ra, hãy nhấn vào một vị trí bất kỳ trên màn hình. Bạn sẽ thấy biểu trưng Google Play Games xuất hiện. Nếu đã thiết lập ứng dụng đúng cách, bạn sẽ thấy lời nhắc đăng nhập.

Không bắt buộc: Tự động tạo bằng Eclipse

Các bước sau đây cho biết cách định cấu hình Eclipse để tự động chạy ndk-build khi bạn thực hiện thay đổi đối với các tệp trong thư mục jni.

  1. Nhấp chuột phải vào dự án MinimalistActivity rồi nhấp vào Properties (Thuộc tính). Trong cửa sổ Properties (Thuộc tính), hãy chọn ngăn Builders (Trình tạo).
  2. Nhấp vào Mới để thêm một Trình tạo mới, rồi chọn Chương trình, sau đó nhấp vào OK.
  3. Trong trường Name (Tên), hãy nhập "NDK Builder".
  4. Trong mục Location (Vị trí), hãy nhấp vào Browse File System (Duyệt hệ thống tệp) rồi chuyển đến thư mục NDK_ROOT và chọn lệnh ndk-build.
  5. Trong phần Working Directory (Thư mục làm việc), hãy nhấp vào Browse Workspace (Duyệt qua không gian làm việc) rồi chọn thư mục dự án MinimalistActivity.
  6. Nhấp vào thẻ Làm mới. Đảm bảo bạn đã đánh dấu vào ô Làm mới tài nguyên sau khi hoàn tất.
  7. Chọn nút chọn Tài nguyên cụ thể rồi nhấp vào Chỉ định tài nguyên. Trong hộp thoại kết quả, hãy chọn thư mục jni trong MinimalActivity.
  8. Nhấp vào Áp dụng rồi nhấp vào OK để hoàn tất việc tạo Trình tạo.

Giờ đây, mỗi khi bạn chỉnh sửa một tệp trong thư mục jni, Eclipse sẽ chạy ndk-build và in đầu ra vào Bảng điều khiển Eclipse.