Cho phép máy chủ truy cập vào Dịch vụ trò chơi của Google Play

Chú ý: Hướng dẫn này dành cho SDK Dịch vụ trò chơi của Play phiên bản 1. Để biết thông tin về SDK mới nhất, vui lòng xem tài liệu về Dịch vụ trò chơi của Play phiên bản 2.

Nếu trò chơi của bạn sử dụng máy chủ phụ trợ, bạn nên sử dụng tính năng Đăng nhập bằng Google để xác thực người chơi và truyền danh tính của người chơi tới máy chủ phụ trợ một cách an toàn. Điều này cũng cho phép trò chơi của bạn truy xuất an toàn danh tính và các dữ liệu khác của người chơi mà không bị lộ dẫn đến nguy cơ bị giả mạo trong quá trình truyền qua thiết bị.

Trong trường hợp này, trò chơi của bạn sẽ nhắc người chơi đăng nhập vào các dịch vụ trò chơi của Google Play như bình thường. Khi người chơi đăng nhập thành công, đối tượng GoogleSignInAccount sẽ chứa một mã sử dụng đặc biệt (còn gọi là mã xác thực máy chủ) mà ứng dụng truyền đến máy chủ. Sau đó, trên máy chủ, hãy đổi mã xác thực máy chủ để lấy mã thông báo OAuth 2.0 mà máy chủ đã dùng để thực hiện lệnh gọi tới API Dịch vụ trò chơi của Google Play.

Để được hướng dẫn thêm về cách thêm tính năng đăng nhập vào trò chơi, vui lòng xem nội dung phần Đăng nhập vào các Trò chơi trên Android.

Để xem mã mẫu chi tiết sử dụng tính năng Đăng nhập bằng Google để xác thực người chơi, hãy xem mẫu clientserverskeleton trên kho lưu trữ GitHub.

Bạn cần thực hiện các bước sau đây để truy cập ngoại tuyến:

1. Trong Google Play Console: hãy tạo thông tin xác thực cho máy chủ trò chơi của bạn. Loại ứng dụng OAuth của thông tin xác thực sẽ là "web".
2. Trên ứng dụng Android: trong quá trình đăng nhập, hãy yêu cầu mã xác thực máy chủ để xác thực thông tin đăng nhập của máy chủ, và truyền mã đó đến máy chủ của bạn.
3. Trên máy chủ trò chơi: Hãy đổi mã xác thực máy chủ để lấy mã truy cập OAuth bằng cách sử dụng dịch vụ xác thực của Google, sau đó dùng mã này để gọi API REST trong dịch vụ trò chơi của Play.

Trước khi bắt đầu

Để có thể tích hợp tính năng Đăng nhập bằng Google vào trò chơi, trước tiên bạn phải thêm trò chơi của mình trong Google Play Console, như mô tả trong bài viết Thiết lập Dịch vụ trò chơi của Google Play.

Tạo một ứng dụng web phía máy chủ được liên kết cho trò chơi của bạn

Dịch vụ trò chơi của Google Play không cung cấp chương trình hỗ trợ cho Trò chơi trên web. Tuy nhiên, hệ thống này cung cấp dịch vụ hỗ trợ máy chủ phụ trợ cho máy chủ trò chơi Android của bạn.

Nếu bạn muốn sử dụng API REST cho Dịch vụ trò chơi của Google Play trong ứng dụng phía máy chủ, hãy làm theo các bước sau:

1. Tạo một ứng dụng web được liên kết cho trò chơi của bạn trong phần Ứng dụng được liên kết của Google Play Console. Lưu ý rằng launch_url không được sử dụng cho luồng này và có thể để trống.
2. Để nhận thông tin đăng nhập cho ứng dụng, hãy làm theo các bước sau:
   1. Từ trò chơi của bạn trong Google Play Console, hãy nhấp vào Chi tiết trò chơi.
   2. Di chuyển xuống mục API Console Project (Dự án bảng điều khiển API) rồi nhấp vào đường liên kết đến dự án API Console.
   3. Từ màn hình API và Dịch vụ & gt; Thông tin xác thực trong Google API Console, hãy tải tệp client_secret.json xuống cho ứng dụng web rồi lưu vào một vị trí mà máy chủ của bạn có thể truy cập. Ghi lại mã ứng dụng khách của thông tin xác thực để tham khảo sau.
3. Khởi động lại ứng dụng phía máy chủ để sẵn sàng chấp nhận yêu cầu của ứng dụng trò chơi.

Đăng nhập trên ứng dụng

Lớp GoogleSignInClient là điểm truy cập chính để truy xuất tài khoản của người chơi hiện đang đăng nhập và để đăng nhập vào người chơi nếu trước đây họ chưa thực hiện việc này trên ứng dụng của bạn trong thiết bị.

Lưu ý: Lớp GoogleSignInClient sử dụng lớp Task của Dịch vụ Google Play để trả về kết quả không đồng bộ. Để tìm hiểu thêm về cách sử dụng tác vụ quản lý các nhiệm vụ theo chuỗi, hãy xem Hướng dẫn dành cho nhà phát triển API Tác vụ.

Để tạo ứng dụng đăng nhập, hãy làm theo các bước sau:

1. Tạo một ứng dụng đăng nhập thông qua đối tượng GoogleSignInOptions. Trong GoogleSignInOptions.Builder để định cấu hình đăng nhập, bạn phải chỉ định GoogleSignInOptions.DEFAULT_GAMES_SIGN_IN.
2. Bạn cũng phải chỉ định rằng trò chơi yêu cầu mã xác thực cho máy chủ phụ trợ bằng cách gọi phương thức GoogleSignInOptions.Builder.requestServerAuthCode() với mã ứng dụng khách của máy chủ dưới dạng thông số. Sau đó, bạn sẽ truy xuất mã xác thực cho mã truy cập trên máy chủ phụ trợ, như mô tả trong phần Lấy mã xác thực máy chủ.
3. Gọi phương thức GoogleSignIn.getClient() và truyền vào các tùy chọn mà bạn đã định cấu hình trước đó. Nếu lệnh gọi thành công, API Đăng nhập bằng Google sẽ trả về một bản sao của GoogleSignInClient.
4. Sau khi đã thu thập được thực thể GoogleSignInClient, bạn nên tiến hành đăng nhập cho người chơi một cách thầm lặng từ onResume() của hoạt động đó, như mô tả trong phần Thực hiện đăng nhập im lặng.

Ví dụ:

private static final int RC_SIGN_IN = 9001;
private GoogleSignInClient mGoogleSignInClient;

private void startSignInForAuthCode() {

  // Client ID for your backend server.
  String webClientId = getString(R.string.webclient_id);

  GoogleSignInOptions signInOption = new
      GoogleSignInOptions.Builder(GoogleSignInOptions.DEFAULT_GAMES_SIGN_IN)
      .requestServerAuthCode(webClientId)
      .build();

  GoogleSignInClient signInClient = GoogleSignIn.getClient(this, signInOption);
  Intent intent = signInClient.getSignInIntent();
  startActivityForResult(intent, RC_SIGN_IN);
}

Lấy mã xác thực máy chủ

Để truy xuất mã xác thực máy chủ mà trò chơi của bạn có thể dùng cho mã truy cập trên máy chủ phụ trợ, hãy gọi phương thức getServerAuthCode() trên đối tượng GoogleSignInAccount để Đăng nhập bằng Google khi đăng nhập thành công của người chơi.

Ví dụ:

// Auth code to send to backend server.
private String mServerAuthCode;

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
  super.onActivityResult(requestCode, resultCode, data);
  if (requestCode == RC_SIGN_IN) {
    GoogleSignInResult result = Auth.GoogleSignInApi.getSignInResultFromIntent(data);
    if (result.isSuccess()) {
      mServerAuthCode = result.getSignInAccount().getServerAuthCode();
    } else {
      String message = result.getStatus().getStatusMessage();
      if (message == null || message.isEmpty()) {
        message = getString(R.string.signin_other_error);
      }
      new AlertDialog.Builder(this).setMessage(message)
          .setNeutralButton(android.R.string.ok, null).show();
    }
  }
}

Trao đổi mã xác thực máy chủ để lấy mã truy cập trên máy chủ

Gửi mã xác thực máy chủ đến máy chủ phụ trợ để trao đổi quyền truy cập và làm mới mã thông báo. Sử dụng mã truy cập để gọi API Dịch vụ trò chơi của Google Play thay mặt cho người chơi và tùy ý lưu trữ mã làm mới để lấy mã truy cập mới khi mã truy cập hết hạn.

Đoạn mã sau đây cho thấy cách bạn có thể triển khai mã máy chủ bằng ngôn ngữ lập trình Java, để trao đổi mã xác thực máy chủ lấy mã truy cập. Công cụ này sử dụng ứng dụng mẫu clientserverskeleton:

/**
 * Exchanges the authcode for an access token credential.  The credential
 * is the associated with the given player.
 *
 * @param authCode - the non-null authcode passed from the client.
 * @param player   - the player object which the given authcode is
 *                 associated with.
 * @return the HTTP response code indicating the outcome of the exchange.
 */
private int exchangeAuthCode(String authCode, Player player) {
try {

    // The client_secret.json file is downloaded from the Google API
    // console.  This is used to identify your web application.  The
    // contents of this file should not be shared.
    //
    File secretFile = new File("client_secret.json");

    // If we don't have the file, we can't access any APIs, so return
    // an error.
    if (!secretFile.exists()) {
        log("Secret file : " + secretFile
                .getAbsolutePath() + "  does not exist!");
        return HttpServletResponse.SC_FORBIDDEN;
    }

    GoogleClientSecrets clientSecrets = GoogleClientSecrets.load(
            JacksonFactory.getDefaultInstance(), new
            FileReader(secretFile));

    // Extract the application id of the game from the client id.
    String applicationId = extractApplicationId(clientSecrets
            .getDetails().getClientId());

    GoogleTokenResponse tokenResponse =
            new GoogleAuthorizationCodeTokenRequest(
            HTTPTransport,
            JacksonFactory.getDefaultInstance(),
            "https://oauth2.googleapis.com/token",
            clientSecrets.getDetails().getClientId(),
            clientSecrets.getDetails().getClientSecret(),
            authCode,
            "")
            .execute();

    log("hasRefresh == " + (tokenResponse.getRefreshToken() != null));
    log("Exchanging authCode: " + authCode + " for token");
    Credential credential = new Credential
            .Builder(BearerToken.authorizationHeaderAccessMethod())
            .setJsonFactory(JacksonFactory.getDefaultInstance())
            .setTransport(HTTPTransport)
            .setTokenServerEncodedUrl("https://www.googleapis.com/oauth2/v4/token")
            .setClientAuthentication(new HttpExecuteInterceptor() {
                @Override
                public void intercept(HttpRequest request)
                        throws IOException {
                        }
            })
            .build()
            .setFromTokenResponse(tokenResponse);

    player.setCredential(credential);

    // Now that we have a credential, we can access the Games API.
    PlayGamesAPI api = new PlayGamesAPI(player, applicationId,
            HTTPTransport, JacksonFactory.getDefaultInstance());

    // Call the verify method, which checks that the access token has
    // access to the Games API, and that the player id used by the
    // client matches the playerId associated with the accessToken.
    boolean ok = api.verifyPlayer();

    // Call a Games API on the server.
    if (ok) {
        ok = api.updatePlayerInfo();
        if (ok) {
            // persist the player.
            savePlayer(api.getPlayer());
        }
    }

    return ok ? HttpServletResponse.SC_OK :
            HttpServletResponse.SC_INTERNAL_SERVER_ERROR;

  } catch (IOException e) {
    e.printStackTrace();
  }
  return HttpServletResponse.SC_INTERNAL_SERVER_ERROR;
}

Để tìm hiểu thêm về cách truy cập API Google từ máy chủ phụ trợ thay mặt cho người chơi đã đăng nhập, hãy xem phần Bật quyền truy cập phía máy chủ.

Xử lý đăng xuất người chơi

Để đăng xuất người chơi ra khỏi trò chơi của bạn, hãy gọi phương thức signOut() trên GoogleSignInClient. Để xem đoạn mã mẫu, hãy xem phần Đăng xuất người chơi khỏi trình phát.

Thực hiện lệnh gọi API REST từ máy chủ

Hãy tham khảo API REST cho dịch vụ trò chơi của Google Play để biết nội dung mô tả đầy đủ về các lệnh gọi API có sẵn.

Dưới đây là ví dụ về các lệnh gọi API REST mà bạn có thể thấy hữu ích:

Người chơi

• Bạn có muốn lấy dữ liệu hồ sơ và mã nhận dạng của người chơi đã đăng nhập? Hãy gọi Players.get với mã 'me' là mã nhận dạng.

Bạn bè

Đảm bảo bạn xem xét hướng dẫn Bạn bè. Phần này sẽ giải thích chi tiết hơn về Bạn bè.

• Bạn có muốn truy xuất danh sách bạn bè của người chơi? Gọi Players.list với 'friends_all' là collection.
• Kiểm tra xem bạn có quyền truy cập vào danh sách bạn bè không? Gọi Players.get cho me và xem trường profileSettings.friendsListVisibility trong phản hồi.

Thành tích

Đảm bảo bạn xem lại hướng dẫn Thành tích, phần này giải thích chi tiết hơn về thành tích.

• Bạn có muốn xem danh sách các thành tích hiện tại không? Bạn có thể gọi đến phương thức AchievementDefinitions.list.
• Hãy kết hợp với một lệnh gọi đến Achievements.list để tìm những người chơi đã mở khóa thành tích.
• Người chơi đã đạt được thành tích chưa? Hãy dùng Achievements.unlock để mở khóa!
• Người chơi có tiến triển thành tích một phần không? Sử dụng tệp Achievements.increment để báo cáo tiến độ (và tìm hiểu xem người chơi đã mở được khóa thành tích hay chưa).
• Bạn có đang gỡ lỗi cho một trò chơi chưa được phát hành chính thức không? Hãy thử gọi phương thức Achievements.reset hoặc Achievements.resetAll từ API quản lý để đặt lại thành tích về trạng thái ban đầu.

Bảng xếp hạng

Đừng quên xem lại hướng dẫn Bảng xếp hạng. Phần này giải thích chi tiết hơn về bảng xếp hạng.

• Bạn có muốn nhận danh sách tất cả các bảng điểm trong trò chơi? Hãy thực hiện một lệnh gọi đến Leaderboards.list
• Người chơi đã chơi xong một trò chơi chưa? Bạn có thể gửi điểm số của họ đến Scores.submit và tìm hiểu xem đây có phải là điểm số cao nhất mới lập hay không.
• Bạn muốn hiển thị một bảng xếp hạng? Lấy dữ liệu từ Scores.list và hiển thị dữ liệu đó cho người dùng.
• Sử dụng phương thức Scores.listWindow để tìm các điểm số gần với điểm cao nhất của người dùng.
• Để biết thêm thông tin về điểm số của người chơi trong một bảng xếp hạng cụ thể (ví dụ: nếu người chơi đó thuộc nhóm 12% người chơi hàng đầu), hãy gọi Scores.get.
• Bạn đang gỡ lỗi cho trò chơi? Hãy thử gọi phương thức Scores.reset có trong API quản lý để đặt lại tất cả điểm số cho người chơi đó từ một bảng xếp hạng cụ thể