Facebookと連携するためのUnity3dプラグインの開発

はじめに

そのため、ソーシャルネットワークとは何か、またそれらがゲーム（および非ゲーム）アプリケーションでどのように使用されるかについては説明しません。 FacebookやTwiterでさまざまな種類のものを公開するようにゲームを教えるというタスクを設定したら、私は言うだけです。
Unity3dエンジンを使用して作成するゲーム。 ソーシャルネットワークを操作するための組み込み機能はありません。 しかし、c / c ++ / Objective c / ...でプラグインを書くことは可能です プラットフォームの母国語で。 これは私がしなければならなかったことでした。 私たちは、それぞれipadとiOSプラットフォームとObjective-C言語用のアプリケーションを開発しています。
以下に、私が何をどのようにしたかを説明します。コードを共有し、尊敬されるhabrasocietyにいくつか質問します。
プラグインがまだ最後までデバッグされていないことをすぐに明確にします！ しかし、共有するものがまだあります。

自転車を作成することは必須ですか？

このようなプラグインを作成するには、いくつかのオプションがあります。

1. 最初の、そしておそらく最も論理的なものは購入することです！ はい、すでに既製のオプションがあり、興味のある人は最も人気のあるリンクを共有できます。 そのようなソリューションの唯一のマイナス点は、Appleまたはソーシャル開発者です。 ネットワークはAPI /フレームワークを簡単に変更できますが、プラグイン開発者がすぐにこれに対応するのは事実ではありません。
2. iOS用Facebook SDKを使用して投稿します 。 同志ザッカーバーグと彼の仲間は、GUIなどでネイティブアプリ用のSDKを書いた かなりうまくいったようです。
3. ここから WebViewおよびClient-side/Server-sideオプションを使用できます。 しかし、アプリケーションがHTML5でない限り、これはモバイルアプリケーションにはあまり便利ではないと思いHTML5

ただし、別のオプションがあります。ご想像のとおり、これについて説明します。 iOS 6のAppleは、Facebookとの緊密な統合を追加しました。 デバイスの設定で、ソーシャルからユーザー名/パスワードを入力できるのと同じ名前のアイテムが表示されました。 ネットワーク。 Twitterにも同じ機会があります。 設定のTwitterが以前のバージョンのiOSで表示された場所。
これらのアカウントを操作するために、Appleはかなり便利なフレームワークAccounts 、 Social 、 Twitter提供しています。 最初のもの- Accounts -デバイス設定でユーザーが設定したアカウントへのアクセスを提供します/主なアイデアはこれです-ソーシャルネットワークのアカウントからユーザー名/パスワードを一度指定します。 ネットワークに接続して、すべてのアプリケーションで使用します。毎回再入力する必要はありません。 2番目- Social -ソーシャルサービスのリクエストを作成するのに役立ちます。 （ネットワーク）要件に応じたネットワーク。 さて、3番目Twitterはこの記事のトピックではありません。 ここでは、Facebookでの作業のみを検討します。
段落の見出しで尋ねられた質問に答えて、私は言うでしょう：私は自転車を発明する価値はなく、購入する方が簡単だったと個人的に思いますが、私は多くの自由時間があり、プラグインを自分で構築してみることにしました。 さらに、追加の経験は誰も気にしませんでした。

Unity3d用のプラグインを作成するための一般原則

すべてが単純です-プラグインをAssets/Plugins/iOSと、次世代のxcode-projectでエンジンによって自動的に選択されます。 プラグインは次のとおりです。

1. コンパイル済みライブラリ-* .a
2. ソースコード-* .m、* .mm、* .cpp、* .c。 もちろん、* .hヘッダーファイルを忘れないでください（ただし、ここでは実際には必要ありません）

C ++またはObjective-Cコードを使用する場合、エクスポートされた関数はCスタイルで宣言して、関数の呼び出し方法の違いによる問題を回避する必要があります。
そしてもう1つの注意-プラグインからの関数は特定のデバイスでのみ呼び出すことができるため、シミュレータでプロジェクトを開始する際の問題を回避するために、（プラグインからプロジェクトに）インポートされたすべての関数は、プロジェクトが実行されているプラ​​ットフォームをチェックするC＃コードでさらにラップすることをお勧めします。
それだけです

Facebookアプリのセットアップ

作業を開始する前に、Facebookでアプリケーションを正しく構成する必要があります。 これが行われない場合、多くの「神秘的な」バグをキャッチできますが、あまりバグではありません。
チューニングの推奨事項は次のとおりです。

1. アプリケーションのタイプNative iOS Appを指定します。 これは2つのページで行われます。設定-基本、アプリケーションをFacebookに組み込む方法を尋ねる場所、および設定-詳細。 ここでは、[ Authentificationセクションの[ App type -> [ Native/Desktopパラメーターに注目します。
2. Bundle ID必ず指定してください。 当然、プロジェクト設定で指定されたものと一致する必要があります。
3. 設定-詳細：[ App Secret in ClientのApp Secret in Client ]パラメーターを[なし]に設定します
4. 設定-基本： Facebook Login -有効

プラグイン操作アルゴリズム

実際、アルゴリズムは非常に単純です-システムからアカウントを取得し、ソーシャルネットワークでデータを公開する権限を要求します。 ネットワーク、公開。 そして、各項目についてさらに詳しく説明します。
上で書いたように、iOS SDKには、設定で指定されたユーザーアカウントへのアクセスを提供するAccountsフレームワークがあります。 実際、彼らだけでなく、他の人も私たちに興味を持っていません。
最初に、アカウントのリポジトリであるACAccountStoreクラスのオブジェクトを作成する必要があります。 次に、クラスACAccountTypeオブジェクトを取得します。このオブジェクトには、関心のあるタイプのすべてのアカウントに関する情報が含まれます。
次の3種類のアカウントがサポートされています。

1. ACAccountTypeIdentifierFacebook -Facebookアカウント
2. ACAccountTypeIdentifierTwitter -Twitterアカウント
3. ACAccountTypeIdentifierSinaWeiboこれは、私たちにとって面白くない、中国のソーシャルです。 ネット

次に、関心のある権限でこのタイプのアカウントへのアクセスをリクエストする必要があります。 権限は各ネットワークに固有であり、文字列の配列として指定されます。
その後、アカウントを安全に受け取り（もちろん、そのようなアカウントが存在し、ユーザーがすべてのウィッシュリストを許可している場合）、必要なものを何でも作成できます。
すべてがシンプルで原始的であるように思われます。 しかし、いや、Facebookの場合ではありません。
アルゴリズムは少し複雑になります。 iOS SDKがFacebookと一緒に送信されないようにするには、また何かを許可するように警告するたびにユーザーを表示する必要がないように、特別な許可要求アルゴリズムを実行する必要があります。

1. 最初に、完全に原始的な個人情報へのアクセスを要求する必要があります。 たとえば、メールで送信します。 ちなみに、ユーザーの個人情報と友人のリストへのアクセスを要求していることがわかりました。
2. 次に（前の段落の許可を取得する場合）、テープの読み取り権を要求する必要があります-read_stream。トリックは、読み取り権の前に（さらに読み取り権を要求せずに）公開の権利を要求できないことです。 また、単一の要求でアクセス権と読み取り権を要求することはできません。
3. さて、今あなたは私たちが興味を持っている権利を要求することができます-publish_stream

考えられるすべての権利/許可の詳細については、 こちらをご覧ください 。
このアルゴリズムが実行されない場合、このようなエラーをキャッチできます。

• Facebookサーバーはこのアクセスリクエストを実行できませんでした：remote_app_idは保存されたIDと一致しません。
• Facebookサーバーは、このアクセス要求を満たすことができませんでした。アプリケーションをインストールできませんでした。
• 他のたくさんの人

このトピックに関するStackoverflowは、興味のある人なら誰でも読むことができます。 そこで、人々は多くのそのようなエラーをレイアウトします！

だから、私はこのコードのようなものを手に入れました（メモリから復元し、今ではすでに変更されていますが、手元に履歴を持つリポジトリはありません）：

 ACAccountStore *store = [[ACAccountStore alloc] init]; ACAccountType *fb_account_type = [store accountTypeWithAccountTypeIdentifier:ACAccountTypeIdentifierFacebook]; NSDictionary *dict = @{ACFacebookAppIdKey : fb_appid, ACFacebookPermissionsKey : @[@"email"], ACFacebookAudienceKey : ACFacebookAudienceEveryone}; [store requestAccessToAccountsWithType:fb_account_type options:dict completion:^(BOOL granted, NSError *error) { if (granted && error == nil) { ACAccountType *fb_account_type = [store accountTypeWithAccountTypeIdentifier:ACAccountTypeIdentifierFacebook]; NSDictionary *dict = @{ACFacebookAppIdKey : fb_appid, ACFacebookPermissionsKey : @[@"read_permission"], ACFacebookAudienceKey : ACFacebookAudienceEveryone}; [store requestAccessToAccountsWithType:fb_account_type options:dict completion:^(BOOL granted, NSError *error) { if (granted && error == nil) { ACAccountType *fb_account_type = [store accountTypeWithAccountTypeIdentifier:ACAccountTypeIdentifierFacebook]; NSDictionary *dict = @{ACFacebookAppIdKey : fb_appid, ACFacebookPermissionsKey : @[@"public_permission"], ACFacebookAudienceKey : ACFacebookAudienceEveryone}; [store requestAccessToAccountsWithType:fb_account_type options:dict completion:^(BOOL granted, NSError *error) { if (granted && error == nil) { //          } }]; } }]; } }]; 

私は同意します、それは不気味に見えます！
dictとfb_account_type絶えず再作成されていることにfb_account_type 。

• dict 。 よく見ると、そこで変更されるのはACFacebookPermissionsKeyだけです。 理論的には、 [dict setObject: forKey:]使用できます。 しかし、コードを記述する段階でさえ、Xcodeはこのメソッドが機能しない可能性があるという警告を出し始めました。 その結果、すべてが実現し、デバイス上で起動しました...まだ落ちました、この方法でした。 私は悔い改め、クラッシュダンプを読みませんでしたが、この方法で問題を回避し、将来のためにTODOを設定しました。
• fb_account_type 。 ここではすべてが少し複雑です。 オブジェクトを再作成せずに、2番目の[store requestAccessToAccountsWithType:options:completion]アプリケーションが安定してクラッシュしました。 別のTODO。

このコードを少し単純化しました。

 void _fb_request_access(NSArray *permissions, FBAccessGrantedHandler handler) { ACAccountType *fb_account_type = [store accountTypeWithAccountTypeIdentifier:ACAccountTypeIdentifierFacebook]; NSDictionary *dict = @{ACFacebookAppIdKey : fb_appid, ACFacebookPermissionsKey : permissions, ACFacebookAudienceKey : ACFacebookAudienceEveryone}; [store requestAccessToAccountsWithType:fb_account_type options:dict completion:^(BOOL granted, NSError *error) { if (granted && error == nil) { handler(); } }]; } _fb_request_access(@[@"email"], ^() { _fb_request_access(@[@"read_stream"], ^() { _fb_request_access(@[@"publish_stream"], ^() { _fb_post_impl(post); }); }); }); 

残念ながら、このコードをテストする時間がありませんでした-ipadは取り去られました（そして、6番目のバージョンでは、それは私たちだけのものです）。 しかし、プロジェクトはエラーなしで組み立てられました。

壁に投稿する

さて、実際に、壁に投稿することについて。 これを行う別の関数_fb_post_implます。

 void _fb_post_impl(NSString *text) { ACAccountType *fb_account_type = [store accountTypeWithAccountTypeIdentifier:ACAccountTypeIdentifierFacebook]; NSArray *accounts = [store accountsWithAccountType:fb_account_type]; fb_account = [accounts objectAtIndex:0]; SLRequest *fb_request = [SLRequest requestForServiceType:SLServiceTypeFacebook requestMethod:SLRequestMethodPOST URL:[NSURL URLWithString:@"https://graph.facebook.com/me/feed"] parameters:[NSDictionary dictionaryWithObject:text forKey:@"message"]]; [fb_request setAccount:fb_account]; [fb_request performRequestWithHandler:^(NSData* responseData, NSHTTPURLResponse* urlResponse, NSError* error) { NSLog([[NSString alloc] initWithData:responseData encoding:NSASCIIStringEncoding]); }]; } 

アルゴリズムは簡単です：

• ACAccountType 。 必要な許可はすべて以前に取得されていることが理解されます。
• 次に、このタイプと必要な権限を持つすべてのアカウントを取得します。
• 結果の配列から、最初の要素を取得します。 このトピックに関する具体的な情報は見つかりませんでしたが、設定からのアカウントのようです。
• さて、投稿してください。

テキストのみを投稿するようになりました。 写真/リンク/タイトル/などを追加するために パラメータ辞書を補足する必要があります。 ここで可能なフィールドのリストを参照してください。 壁に掲示するだけでなく、 これを読むこともお勧めします。

Cでプラグイン関数を呼び出す＃

実際、ここではすべてがシンプルで原始的です。

  [DllImport ("__Internal")] private static extern void _fb_init(String appid); [DllImport ("__Internal")] private static extern void _fb_post(String text); public static void fb_init() { _fb_init(" application id"); } public static void fb_post(String text) { _fb_post(text); } 

小さなメモ-C＃のString型には、プラグインのconst char*に対応します。 たとえば、最初にNSStringを使用しようとしました。

結論の代わりに

その結果、私はなんとかテキストだけを壁に投稿することができました。 確かに、私が書いたこれらの小さな妨害のために、計り知れないほどの時間を費やしました-デバイスでのみプラグインを使用する、許可を取得するためのトリッキーなアルゴリズム。
コードはbitbucket-bitbucket.org/mnazarov/fb_pluginにアップロードされました。
ちなみに、Objective-Cに初めて出会ったので、多くを蹴るのではなく、理解するようお願いします。 コードを改善するためのヒントを喜んで受け取ります。
また、誰かが自分のデバイスを試して、どのように機能するかを解除できるかどうかも嬉しいです。
誰かが開発を支援することに決めたら、私はとてもうれしいです！
さて、いくつか質問があります：

1. 辞書で間違ったこと、 [dict:setObject:forKey]メソッドが機能しなかったこと。 Xcodeはこのメソッドを知っていたにもかかわらず、同じStackoverflowで、人々は私のと同じケースでそれを使用しています。
2. 2番目の質問は、iPadでのデバッグに関するものです。デバッグ方法、「神秘的な」バグのキャッチ方法です。 特に、このプラグインをデバッグするとき、NSLog呼び出しでアプリケーションが単純にクラッシュする状況を観察しました！
   クラッシュダンプを読み取ろうとしましたが、何もわかりませんでした。
   

PSこの記事が誰かの神経細胞を救うことを願っています。