Skip to content

iOS Implement Unity SDK

osawa-shunsuke edited this page Feb 22, 2016 · 2 revisions

Unity iOS Lobi SDK 組み込み手順

LobiCore を導入する方法について説明します。 他のSDKの導入方法については、サイドメニューから各SDKのドキュメントページをご参照下さい。


事前にお読みください

Unity 導入準備

  • 対応OS: iOS 5.1 またはそれ以降のバージョン
  • 対応アーキテクチャ: armv7, armv7s, arm64
  • 事前に用意いただくファイル・情報
    • LobiCoreフレームワーク・バンドル (LobiSDK統合フレームワーク)
    • LobiRecフレームワーク・バンドル
    • Client ID

導入に必要な資材

  • LobiCore.framework
  • LobiCore.bundle
  • Client ID

Lobi SDKを利用するには、クライアントIDを用意する必要があります。
クライアントIDは開発者向けページにて取得することができます。
詳しくはLobi SDK導入までのフローを参照してください。

インストール手順 - iOS Unity

Unity 5 での導入

Unity 5での導入に関しては、LobiSDK Unity5も合わせてご参照下さい。

Unitypackageの構成

  • Lobi.unitypackage

LobiSDKとUnityプログラムとの連携を行うためのファイルが格納されたUnityパッケージです。
全てのフレームワークはLobiCoreに依存するため、LobiCore*を含めてください。

(例)LobiCoreフレームワークを利用する場合に必要なコード

- Plugins/iOS/LobiCoreCommon.h
- Plugins/iOS/LobiCoreAPICommon.h
- Plugins/iOS/LobiCoreAPICommon.m
- Plugins/iOS/LobiCoreBridge.h
- Plugins/iOS/LobiCoreBridge.m
- Plugins/iOS/LobiCoreAPIBridge.m
- Scripts/LobiCoreBridge.cs
- Scripts/LobiCoreAPIBridge.cs

Unityプロジェクトへの追加

通常のUnityパッケージと同様にAssets->Import Package->Custom Package...からLobi.unitypackageを選択し、インポートしてください。

Xcodeプロジェクトの自動設定

Unityメニューの [Edit]-[Lobi Settings] を選択すると、Inspector に Lobi設定画面が表示されます。

「1) cliendID、accountBaseName」を入力し、「2) [iOS enabled]」 のチェックをオンにしてXcodeプロジェクトを出力すると、LobiSDK v5.3.3以前のバージョンで必要だった手順の「Xcodeプロジェクトへの追加」〜「プログラムの実装 - Lobi SDK初期化処理」の設定が自動で実行されます。

ただし、「LobiRecフレームワークの追加」の自動実行には、事前に Unity プロジェクトの"Assets/Plugins/Lobi/iOS"へ必要な bundle ファイルと framework ファイルをインポートする必要があります。

SDK 必要なファイル
全て LobiCore.framework、LobiCore.bundle
REC LobiRec.framework、LobiRec.bundle
ランキング LobiRanking.framework、LobiRanking.bundle
  • clientID (必須)
    開発者向けページ(http://developer.lobi.co)から取得したIDを指定してください。

  • accountBaseName (必須)
    LobiSDKにサインアップする際のデフォルトのユーザー名となります。
    ユーザー名が重複している場合には自動的に異なるユーザー名に変更されます。
    例えば、accountBaseNameを"勇者"とした場合、ユーザー名は"勇者1", "勇者2", "勇者3" ...となります。
    製作アプリにアカウントの概念が存在する場合、そのアカウント名をaccountBaseNameとすることを推奨します。
    アカウントの概念が存在しない場合には固定値を入れることも可能です。 連番部分を含めて1〜20文字になるような文字列を設定してください。

NOTE
Lobi.unitypackage ファイルをインポートするときに、使用しない SDK のファイルをインポートすると、Xcode プロジェクトのビルド時にエラーが発生する可能性があります。もしインポートした場合は Unity プロジェクトから削除してください。

使用しない SDK 削除するファイル
REC ファイル名に"LobiRec"が含まれるファイル
ランキング ファイル名に"LobiRanking"が含まれるファイル

NOTE
アプリ内で main.mmAppControllerClassName の値を書換えている場合、Lobi の初期化処理などが実行されないため、Lobi の機能を利用することができません。その場合は、Xcode プロジェクトの Libraries/LobiUnityAppController.mm 内の処理を適切な位置へ手動で追加してください。

テストボタンの表示

Lobi設定画面の「3) [Enable test buttons]」のチェックをオンにし、シーンに"Assets/LobiSDK/Scripts/LobiTestButton"プレハブを配置した状態でXcodeプロジェクトを出力すると、ゲーム画面にLobiテスト用のボタンが表示されます。

アカウントの作成

LobiSDK のアカウントの作成方法およびLobiアプリとの連携方法に関しては、下記ドキュメントをご参照下さい。

LobiSDKのアカウントについて

LobiSDKの多言語化対応

LobiSDKは現在、日本語と英語の表記に対応しています。 日本語のみを対象としているゲーム内のLobiSDKにおいて英語しか表示されないといった場合には、導入されるプロジェクト自体のデフォルト言語を変更する必要があります。

下図のようにTARGETのInfoタブより、Localization native development regionの値をJapanに設定し、Localizationsの値をJapaneseに変更することで対応可能です。

デフォルトの言語を変更しても日本語のLobiSDKが表示されない場合は、プロジェクトにInfoPlist.stringsを追加します。

Xcode右のユーティリティを開き、InfoPlist.stringsのローカライズを行います。

追加したInfoPlist.stringsが言語ごとに作成されます。

よくある質問


他のフレームワークの実装・導入

Clone this wiki locally