ソーシャル API

ノート: ソーシャル API は非推奨になり、将来のリリースで削除される予定です。

ソーシャル API は Unity のソーシャル機能をアクセスするための接点です

• ユーザープロファイル
• フレンドリスト
• ゲーム実績（ Achievements ）
• 統計/ランキング（ Statistics / Leaderboards ）

ソーシャル API は、GameCenter などの異なるソーシャルバックエンドに統合したインターフェースを提供します。そして、主に、ゲームプロジェクトに携わるプログラマーが使用するためにあります。

ソーシャル API は主に非同期 API であり、標準的な使い方は関数呼び出しを行い関数の完了時にコールバックを登録します。非同期の関数は副作用があり、API で特定の状態変数に値を生成したり、コールバックがサーバーで処理すべきデータを含んだりする可能性があります。

Social クラスは UnityEngine 名前空間にあるため、常に利用可能ですが、他のソーシャル API のクラスは UnityEngine.SocialPlatforms という別の名前空間にあります。さらにソーシャル API の実装は SocialPlatforms.GameCenter など下位の名前空間にあります。

ソーシャル API の使用例を以下に示します。

using UnityEngine;
using UnityEngine.SocialPlatforms;

public class SocialExample : MonoBehaviour {

    void Start () {
        // Authenticate and register a ProcessAuthentication callback
        // This call needs to be made before we can proceed to other calls in the Social API
        Social.localUser.Authenticate (ProcessAuthentication);
    }

    // This function gets called when Authenticate completes
    // Note that if the operation is successful, Social.localUser will contain data from the server.
    void ProcessAuthentication (bool success) {
        if (success) {
            Debug.Log ("Authenticated, checking achievements");

            // Request loaded achievements, and register a callback for processing them
            Social.LoadAchievements (ProcessLoadedAchievements);
        }
        else
            Debug.Log ("Failed to authenticate");
    }

    // This function gets called when the LoadAchievement call completes
    void ProcessLoadedAchievements (IAchievement[] achievements) {
        if (achievements.Length == 0)
            Debug.Log ("Error: no achievements found");
        else
            Debug.Log ("Got " + achievements.Length + " achievements");

        // You can also call into the functions like this
        Social.ReportProgress ("Achievement01", 100.0, result => {
            if (result)
                Debug.Log ("Successfully reported achievement progress");
            else
                Debug.Log ("Failed to report achievement");
        });
    }
}

ソーシャル API の詳細については、ソーシャル API スクリプティングリファレンス を参照してください。