安装和初始化

AppMetrica Push Unity 是为 Unity3d 游戏平台开发的插件，包含对 AppMetrica Push SDK（Android 和 iOS 平台）的支持。

此部分介绍如何启用并初始化 AppMetrica Unity Plugin：

步骤 1. 启用 AppMetrica Unity 插件

要启用 AppMetrica Unity 插件，请按照说明操作。

备注

您必须使用 AppMetrica Unity 插件版本 6.1.0 或更高。

Stage 2. 启用 AppMetrica Push Unity 插件

插件通过 Unity Package Manager 启用。

将以下依赖项添加到 Packages/manifest.json：

{
  "dependencies": {
    "io.appmetrica.analytics.push": "https://github.com/appmetrica/push-unity-plugin.git#v2.0.0"
  }
}

步骤 3. 初始化库

您应该使用 RuntimeInitializeOnLoadMethodAttribute 属性来激活 AppMetrica Push。

创建一个静态方法，添加 [RuntimeInitializeOnLoadMethod(RuntimeInitializeLoadType.BeforeSceneLoad)] 属性，然后使用 AppMetricaPush.Activate() 方法激活 AppMetricaPush。

Example:

using Io.AppMetrica;
using Io.AppMetrica.Push;
using UnityEngine;

public static class AppMetricaActivator {
    [RuntimeInitializeOnLoadMethod(RuntimeInitializeLoadType.BeforeSceneLoad)]
    private static void Activate() {
        AppMetrica.Activate(new AppMetricaConfig("APIKey"));
        AppMetricaPush.Activate();
    }
}

备注

你必须在调用 AppMetricaPush.Activate() 时严格保证先调用 AppMetrica.Activate().

Stage 4. 为每种本地平台添加设置

Android

iOS

为使用 Firebase 设置应用获取并添加到 AppMetrica 用于使用 Firebase Cloud Messaging 的服务器密钥。
要配置 AndroidManifest.xml，请在 application 元素中修改 AndroidManifest.xml：
```
<meta-data android:name="ymp_firebase_default_app_id" android:value="APP_ID"/>
<meta-data android:name="ymp_gcm_default_sender_id" android:value="number:SENDER_ID"/>
<meta-data android:name="ymp_firebase_default_api_key" android:value="API_KEY"/>
<meta-data android:name="ymp_firebase_default_project_id" android:value="PROJECT_ID"/>
```
APP_ID — 应用在 Firebase 中的 ID。您可以在 Firebase 控制台中找到它：转到 项目设置。在 您的应用 部分，复制 应用 ID 字段的值。

SENDER_ID — Firebase 中发送者的唯一 ID。您可以在 Firebase 控制台中找到它：转到 项目设置 → 云消息传递，并复制 发送者 ID 字段的值。

API_KEY — Firebase 中的应用密钥。您可以在 google-services.json 文件的 current_key 字段中找到它。您可以在 Firebase 控制台中下载该文件。

PROJECT_ID — Firebase 中的应用 ID。您可以在 google-services.json 文件的 project_id 字段中找到它。您可以在 Firebase 控制台中下载该文件。

将SSL证书添加到AppMetrica，按照说明操作。
要收到推送通知，请请求用户的许可。我们建议使用 Mobile Notifications Unity 包，并根据说明请求权限。

备注

AppMetrica Push Unity 插件使用 swizzling：它通过 ObjectiveC 运行时拦截 UnityAppController 类的某些方法的执行。你可以在 AMPUAppMetricaPushAppController.m 文件中找到 swizzling 机制的源代码。

另请参见

如果您没有找到所需答案，可以通过反馈表单提交您的问题。请尽可能详细地描述问题。如果可能，请附上截图。

联系支持为文档提出改进建议

这篇文章是否有用？

使用示例

Flutter