高度な実装
このリファレンス記事では、Unityプラットフォーム向けの高度なSDK実装について説明する。
Unityパッケージをカスタマイズする
提供されているスクリプトを使用して、Braze Unity パッケージをカスタマイズしてエクスポートすることもできます。
-
Braze Unity SDK GitHub プロジェクトを複製します。
1
git clone [email protected]:braze-inc/braze-unity-sdk.git
braze-unity-sdk/scripts
ディレクトリから、./generate_package.sh
を実行し、Unity パッケージをエクスポートする。generate_package.sh
を実行している間は、Unity を開いておく必要があります。- パッケージは
braze-unity-sdk/unity-package/
にエクスポートされる。 - Unity エディターで Unity プロジェクトに任意のパッケージをインポートするには、[アセット] > [パッケージをインポート] > [カスタムパッケージ] の順に移動します。
- (オプション)インポートしたくないファイルの選択を解除する。
generate_package.sh
とAssets/Editor/Build.cs
にあるエクスポートスクリプトの両方を編集することで、エクスポートされたUnityパッケージをカスタマイズできる。
Prime 31 の互換性
Prime31 プラグインで Braze Unity プラグインを使用するには、Prime31 互換の Activity クラスを使用するようにプロジェクトの AndroidManifest.xml
を編集します。の参照をすべて変更する。
com.braze.unity.BrazeUnityPlayerActivity
のすべての参照を com.braze.unity.prime31compatible.BrazeUnityPlayerActivity
に変更します
Amazon ADM プッシュ
Braze では、Unity アプリへの Amazon ADM プッシュの統合がサポートされています。Amazon ADMプッシュを統合したい場合は、ADM APIキーを含むapi_key.txt
というファイルを作成し、Plugins/Android/assets/
フォルダに置く。 Amazon ADM と Braze の統合の詳細については、ADM プッシュ統合手順を参照してください。
Android SDKの高度な実装オプション
Unityエディタで冗長ロギングを有効にする
Unityエディターで冗長ロギングを有効にするには、以下のようにする:
- [Braze] > [Braze 構成] の順に移動して、[Braze 構成設定] を開きます。
- [Braze Android 設定を表示する] ドロップダウンをクリックします。
- [SDK ログレベル] フィールドに値「0」を入力します。
Braze Unity プレーヤーを拡張する (Android)
提供されている AndroidManifest.xml
ファイルの例では、1つの Activity クラス BrazeUnityPlayerActivity
が登録されています。このクラスは Braze SDK と統合され、セッション処理、アプリ内メッセージ登録、プッシュ通知分析ログなどを使用して UnityPlayerActivity
を拡張します。UnityPlayerActivity
クラスの拡張の詳細については、「Unity」を参照してください。
ライブラリやプラグインプロジェクトで独自のカスタムUnityPlayerActivity
を作成する場合は、カスタム機能をBrazeと統合するために、当社のBrazeUnityPlayerActivity
を拡張する必要がある。BrazeUnityPlayerActivity
を拡張する作業を始める前に、Unity プロジェクトに Braze を統合するための手順に従ってください。
- Braze Android SDK統合の説明に従って、Braze Android SDK をライブラリまたはプラグインプロジェクトに依存関係として追加します。
- Unity 固有の機能を含む Unity
.aar
を、Unity 用に構築している Android ライブラリプロジェクトに統合します。appboy-unity.aar
は、公開リポジトリから入手できます。Unity ライブラリがうまく統合されたら、BrazeUnityPlayerActivity
を拡張するようにUnityPlayerActivity
を変更します。 - ライブラリまたはプラグインプロジェクトをエクスポートし、通常どおり
/<your-project>/Assets/Plugins/Android
にドロップします。ライブラリやプラグインにBrazeのソースコードを含めないこと。それらはすでに/<your-project>/Assets/Plugins/Android
に存在するからである。 /<your-project>/Assets/Plugins/Android/AndroidManifest.xml
を編集し、BrazeUnityPlayerActivity
のサブクラスをメイン・アクティビティとして指定する。
これでUnity IDEから、Brazeと完全に統合され、カスタムUnityPlayerActivity
機能を含む.apk
をパッケージできるようになるはずだ。
iOS SDKの高度な実装オプション
Unityエディタで冗長ロギングを有効にする
Unityエディターで冗長ロギングを有効にするには、以下のようにする:
- [Braze] > [Braze 構成] の順に移動して、[Braze 構成設定] を開きます。
- Show Braze iOS Settingsドロップダウンをクリックする。
- [SDK ログレベル] フィールドに値「0」を入力します。
SDKを拡張する(iOS)
SDK の動作を拡張するには、Braze Unity SDK GitHubプロジェクトをフォークし、必要な変更を行います。
修正したコードを Unity パッケージとして公開するには、高度なユースケースを参照してください。
手動から自動統合への移行(iOS)
Braze Unity SDKで提供される自動化されたiOSインテグレーションを利用するには、手動から自動化されたインテグレーションに移行するための以下のステップに従う。
- Xcodeプロジェクトの
UnityAppController
サブクラスから、Braze関連のコードをすべて削除する。 - Unity プロジェクトまたは Xcode プロジェクト (
Appboy_iOS_SDK.framework
およびSDWebImage.framework
など) から Braze iOS ライブラリを削除し、Braze Unity パッケージを Unity プロジェクトにインポートします。 - Unity で API キーを設定する統合手順に従います。