ソーシャル API は Unity のソーシャル機能をアクセスするための接点です
ソーシャル API は、 GameCenter などの異なるソーシャルバックエンドに統合したインターフェイスを提供します。そして、主に、ゲームプロジェクトに携わるプログラマーが使用するためにあります。
ソーシャル API は主に非同期 API であり、標準的な使い方は関数呼び出しを行い関数の完了後にコールバックを登録します。非同期の関数は副作用があり、API で特定の状態変数に値を生成したり、コールバックはサーバーで処理すべきデータを含む可能性があります。
ソーシャルクラスは UnityEngine 名前空間にあるため、常に利用可能ですが、ソーシャル API クラスは UnityEngine.SocialPlatforms という別の名前空間にあります。さらにソーシャル API の実装は SocialPlatforms.GameCenter など名前空間の下位の階層にあります。
次がソーシャル API の使用例です(JavaScript)
import UnityEngine.SocialPlatforms;
function Start () {
// ProcessAuthentication コールバックを認証し登録します。
// Social API の他の呼び出しを始める前に、この呼び出しが必要です。
Social.localUser.Authenticate (ProcessAuthentication);
}
// Authenticate が終了したときにこの関数が呼び出されます。
// 操作が成功したら、Social.localUser はサーバーからのデータを格納します
function ProcessAuthentication (success: boolean) {
if (success) {
Debug.Log ("Authenticated, checking achievements");
// loaded achievements を招集し、それを処理するためのコールバックを登録します
Social.LoadAchievements (ProcessLoadedAchievements);
}
else
Debug.Log ("Failed to authenticate");
}
// LoadAchievement コールが終了すると、関数が呼び出されます。
function ProcessLoadedAchievements (achievements: IAchievement[]) {
if (achievements.Length == 0)
Debug.Log ("Error: no achievements found");
else
Debug.Log ("Got " + achievements.Length + " achievements");
// このように関数を呼び出すこともできます
Social.ReportProgress ("Achievement01", 100.0, function(result) {
if (result)
Debug.Log ("Successfully reported achievement progress");
else
Debug.Log ("Failed to report achievement");
});
}
同じサンプルで C# を使用した例です。
using UnityEngine;
using UnityEngine.SocialPlatforms;
public class SocialExample : MonoBehaviour {
void Start () {
// ProcessAuthentication コールバックを認証し登録します。
// Social API の他の呼び出しを始める前に、この呼び出しが必要です。
Social.localUser.Authenticate (ProcessAuthentication);
}
// Authenticate が終了したときにこの関数が呼び出されます。
// 操作が成功したら、Social.localUser はサーバーからのデータを格納します。
void ProcessAuthentication (bool success) {
if (success) {
Debug.Log ("Authenticated, checking achievements");
// loaded achievements を招集し、それを処理するためのコールバックを登録します
Social.LoadAchievements (ProcessLoadedAchievements);
}
else
Debug.Log ("Failed to authenticate");
}
// LoadAchievement コールが終了すると、関数が呼び出されます。
void ProcessLoadedAchievements (IAchievement[] achievements) {
if (achievements.Length == 0)
Debug.Log ("Error: no achievements found");
else
Debug.Log ("Got " + achievements.Length + " achievements");
// このように関数を呼び出すこともできます
Social.ReportProgress ("Achievement01", 100.0, result => {
if (result)
Debug.Log ("Successfully reported achievement progress");
else
Debug.Log ("Failed to report achievement");
});
}
}
ソーシャル API の詳細については Social を参照してください。
Did you find this page useful? Please give it a rating:
Thanks for rating this page!
What kind of problem would you like to report?
Thanks for letting us know! This page has been marked for review based on your feedback.
If you have time, you can provide more information to help us fix the problem faster.
Provide more information
You've told us this page needs code samples. If you'd like to help us further, you could provide a code sample, or tell us about what kind of code sample you'd like to see:
You've told us there are code samples on this page which don't work. If you know how to fix it, or have something better we could use instead, please let us know:
You've told us there is information missing from this page. Please tell us more about what's missing:
You've told us there is incorrect information on this page. If you know what we should change to make it correct, please tell us:
You've told us this page has unclear or confusing information. Please tell us more about what you found unclear or confusing, or let us know how we could make it clearer:
You've told us there is a spelling or grammar error on this page. Please tell us what's wrong:
You've told us this page has a problem. Please tell us more about what's wrong:
Thank you for helping to make the Unity documentation better!
Your feedback has been submitted as a ticket for our documentation team to review.
We are not able to reply to every ticket submitted.