Flurry Analytics游戏事件

概述

Flurry是ios方面的第三方分析提供者。 他们的API和服务是免费使用的。 我们在UE3中集成此功能使得添加游戏过程事件和将此上传给Flurry变得很容易。 然而我们并不提供实际的SDK。 如您需要更多相关账号设置来下载必要工具的信息，请访问http://www.flurry.com/

设置使用Flurry

Flurry账号

为使用Flurry，您首先需要通过他们的网站创建一个账号，http://www.flurry.com/. 您一旦完成上述工作，您可以下载他们的SDK并为您的游戏添加一个独特的应用项。 您还可以通过发送给他人邮件邀请来创建新的非管理员账户，从而使其他人能看到这些统计数据。

注意： 在开发时，如需创建临时游戏事件以供测试，那么创建一个开发者专用的应用程序是不错的主意。 当您准备要发布时，您可以创建一个仅供发布使用的应用程序，该程序仅能供游戏在制作环境中使用。

UE3 配置

UE3中的配置相对简单并可以通过一些ini的值来完成。 以下内容应被加入到您的游戏的IPhoneEngine.ini：

这是实例化FlurryAnalyticsIPhone使之成为引擎内的分析功能的类名。

[PlatformInterface]
AnalyticEventsInterfaceClassName=IPhoneDrv.FlurryAnalyticsIPhone

这是设置Flurry的设置部分。 首先要添加您的应用程序的API钥匙。 注意同时存在"ApiKeyDev" 和 "ApiKeyRelease". 当ios游戏在制作中时，发布版本会自动被使用。 当您从Flurry的网站下载SDK时，您应该会收到您的应用程序的API钥匙。

[IPhoneDrv.FlurryAnalyticsIPhone]
ApiKeyDev="your dev only key"
ApiKeyRelease="your production key"

其他的设置值:

* bUseSecureTransport -设置数据通过SSL传送（默认为FALSE) * bEnableDebugLogs - 为Flurry支持生成调试日志（默认为FALSE) * bShowErrorLogs -记录所有的错误信息（默认为FALSE) * bEnableEventLogs -记录所有的事件信息（默认为FALSE) * bReportOnClose -当应用程序关闭时，上传会话报告（默认为TRUE） * bReportOnPause -当应用程序被停用时，上传会话报告（默认为FALSE）

增加游戏时事件

Flurry事件只以字符串显示。 在允许的唯一事件数量和唯一事件参数上也有一些限制。 参照Flurry网站参阅此类限制的更多信息。

使用已存的游戏统计系统

查阅InstrumentingGameStatistics来看UE3的游戏统计系统是如何捕捉和回放游戏事件的更多信息。 这些同样的事件也可以通过创建您自己的GameplayEventsUploadAnalytics.uc的子类来上传到Flurry。 这使得您添加的游戏事件可被直接上传，而不是像GameplayEventsWriter.uc所作的那样将此缓存到硬盘。

使用Flurry原始事件

另一个选择是简单地使用Analytics界面来自己写原始事件而不使用内置的游戏统计系统。

这可以通过首先获取Analytics界面的单例模式（使用Flurry实例实施）:

local AnalyticEventsBase Analytics;
Analytics = class'PlatformInterfaceBase'.static.GetAnalyticEventsInterface();

然后您可以开始analytics对话来开始记录您的自定义事件：

Analytics.StartSession();

这是一个例子，展示了增加一个简单的无参数字符串事件。

Analytics.LogStringEvent("Event without parameters",false);

这是一个例子，展示了增加一组字符串参数的字符串事件。

local array<EventStringParam> Params;

Params.Add(1);
Params[Params.Length-1].ParamName = "Param Name 1";
Params[Params.Length-1].ParamValue = "Param Name 1";

Params.Add(1);
Params[Params.Length-1].ParamName = "Param Name 2";
Params[Params.Length-1].ParamValue = "Param Value 2";

Analytics.LogStringEventParamArray("Event with parameters",Params,false);