AttachGameCenterIdentity

Attach a Game Center identity to the current profile.

Service	Operation
identity	ATTACH

Method Parameters

Parameter	Description
gameCenterId	The user's Game Center ID — can be the PlayerId, GamePlayerId, or TeamPlayerId from the GKLocalPlayer object
timestamp	The timestamp value returned as part of the identity verification signature fetch from Game Center. Required for modern Game Center verification.
publicKeyUrl	The public key URL returned as part of the identity verification signature fetch from Game Center. Required for modern Game Center verification.
signature	The raw signature bytes returned from Game Center (via GetSignature()). Required for modern Game Center verification.
salt	The raw salt bytes returned from Game Center (via GetSalt()). Required for modern Game Center verification.
teamPlayerId	Only required when gameCenterId is set to a value other than TeamPlayerId.

Usage

http://localhost:3000

C#

string gameCenterId = "someId"; // PlayerId, GamePlayerId, or TeamPlayerId
ulong timestamp = 0;        // from GKLocalPlayer identity verification
string publicKeyUrl = "";   // from GKLocalPlayer identity verification
byte[] signature = null;    // from GKLocalPlayer GetSignature()
byte[] salt = null;         // from GKLocalPlayer GetSalt()
string teamPlayerId = "";   // only if gameCenterId is not TeamPlayerId

_bc.IdentityService.AttachGameCenterIdentity(
    gameCenterId, timestamp, publicKeyUrl,
    signature, salt, teamPlayerId,
    SuccessCallback, FailureCallback);

C++

const char* gameCenterId = "someId"; // playerId, gamePlayerId, or teamPlayerId
uint64_t timestamp = 0;           // from GKLocalPlayer identity verification
std::string publicKeyUrl = "";    // from GKLocalPlayer identity verification
const uint8_t* signature = NULL;  // from GKLocalPlayer GetSignature()
size_t signatureLength = 0;
const uint8_t* salt = NULL;       // from GKLocalPlayer GetSalt()
size_t saltLength = 0;
std::string teamPlayerId = "";    // only if gameCenterId is not teamPlayerId

_bc->getIdentityService()->attachGameCenterIdentity(
    gameCenterId, timestamp, publicKeyUrl,
    signature, signatureLength, salt, saltLength,
    teamPlayerId, this);

Obj-C

- (void)attachGameCenterIdentity:(NSString *)gameCenterId
                       timestamp:(uint64_t)timestamp
                    publicKeyUrl:(NSString *)publicKeyUrl
                       signature:(NSData *)signature
                            salt:(NSData *)salt
                    teamPlayerId:(NSString *)teamPlayerId
                 completionBlock:(BCCompletionBlock)cb
            errorCompletionBlock:(BCErrorCompletionBlock)ecb
                        cbObject:(BCCallbackObject)cbObject;

Java

public void attachGameCenterIdentity(String gameCenterId, long timestamp, String publicKeyUrl, byte[] signature, byte[] salt, String teamPlayerId, IServerCallback callback)

JavaScript

_bc.identity.attachGameCenterIdentity = function(gameCenterId, timestamp, publicKeyUrl, signature, salt, teamPlayerId, callback)

Dart

var gameCenterId = "someId"; // playerId, gamePlayerId, or teamPlayerId
int timestamp = 0;             // from GKLocalPlayer identity verification
String publicKeyUrl = "";      // from GKLocalPlayer identity verification
List<int>? signature = null;   // from GKLocalPlayer GetSignature()
List<int>? salt = null;        // from GKLocalPlayer GetSalt()
String teamPlayerId = "";      // only if gameCenterId is not teamPlayerId

ServerResponse result = await _bc.identityService.attachGameCenterIdentity(
    gameCenterId: gameCenterId,
    timestamp: timestamp,
    publicKeyUrl: publicKeyUrl,
    signature: signature,
    salt: salt,
    teamPlayerId: teamPlayerId);

if (result.statusCode == 200) {
    print("Success");
} else {
    print("Failed ${result.error['status_message'] ?? result.error}");
}

Roblox

local gameCenterId = "someId" -- playerId, gamePlayerId, or teamPlayerId
local timestamp = 0          -- from GKLocalPlayer identity verification
local publicKeyUrl = ""      -- from GKLocalPlayer identity verification
local signature = nil        -- from GKLocalPlayer GetSignature()
local salt = nil             -- from GKLocalPlayer GetSalt()
local teamPlayerId = ""      -- only if gameCenterId is not teamPlayerId

local callback = function(result)
    if result.statusCode == 200 then
        print("Success")
    else
        print("Failed | " .. tostring(result.status))
    end
end

_bc:getIdentityService():attachGameCenterIdentity(
    gameCenterId, timestamp, publicKeyUrl,
    signature, salt, teamPlayerId, callback)

GDScript

var game_center_id = "someId"
var timestamp = 0
var public_key_url = ""
var team_player_id = ""

var result = await _bc.identity_service.attach_game_center_identity(game_center_id)

if result.status == 200:
	print("Success")
else:
	print("Failed: %s" % result.status_message)

Cloud Code

// N/A

Raw

// N/A

JSON Response

{
    "status": 200,
    "data": null
}

Common Error Code

Status Codes

Code	Name	Description
40211	DUPLICATE_IDENTITY_TYPE	Returned when trying to attach an identity type that already exists for that profile. For instance you can have only one Game Center identity for a profile.
40212	MERGE_PROFILES	Returned when trying to attach an identity type that would result in two profiles being merged into one (for instance an anonymous account and a Game Center account).