IGAWorks Help Center

adPOPcorn PlusLock

是成为 adPOPcorn PlusLock 积分墙的附加功能，通过锁定屏幕支持参与广告的收益型服务。

为了使用 PlusLock，须将集成积分墙并请参考如下。

注意事项

集成 PlusLock add-on 之前，必须先完成 adPOPcorn 积分墙集成。
[adPOPcorn 积分墙 : Android] & [adPOPcorn 积分墙 : Unity Android]
为了集成 adPOPcorn，须将 IgawPlusLock~*.jar 文件包含在 Android Project 内。
[SDK 安装 : Android] & [SDK 安装 : Unity]
PlusLock 服务的最低配置是在 IgawAdpopcorn 4.0 版本以上。

AndroidManifest.xml

为了集成 PlusLock，请修改 AndroidManifest。

添加 Permission

设置 android Manifest 文件。

<manifest></manifest> 标签内添加需要的 permission，才能正常驱动 PlusLock。

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED"/>

android:process 的情况，添加的值相同于 IgawPlusLockService 的 process 设置的值。

<service android:label="PlusLock" android:name="com.igaworks.adpopcorn.pluslock.IgawPlusLockRestartService"
             android:process="com.igaworks.pluslock">
</service>

<manifest></manifest> 标签内添加 permission。此 permission 为选项。若添加 permission，在连接 wifi 状态下，会开启自动下载视频的功能。(未添加 permission 的话，无法使用此功能。)

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

添加 LargeHeap 选项

<application> 标签，如下添加 LargeHeap 选项。为了锁定屏幕上曝光多个图标的需要选项。

<application
	{ 省略 }
	android:largeHeap="true">

添加 Activity

<application></application> 标签内添加需要的 Activity。

<activity android:name="com.igaworks.adpopcorn.pluslock.activity.PlusLockActivity"
    android:theme="@android:style/Theme.NoTitleBar"
    android:screenOrientation="portrait"
    android:excludeFromRecents="true" />
			
<activity android:name="com.igaworks.adpopcorn.pluslock.activity.PlusLockRewardAdActivity"
    android:theme="@android:style/Theme.NoTitleBar"
    android:screenOrientation="landscape"
    android:excludeFromRecents="true" />

添加 PlusLock 服务

<application></application> 标签内添加 PlusLock 服务。

<service  android:label="PlusLock" android:name="com.igaworks.adpopcorn.pluslock.IgawPlusLockService"
        android:process="com.igaworks.pluslock">
</service>

添加 PlusLock Receiver

<application></application> 标签内添加 PlusLock Receiver。

<receiver android:name="com.igaworks.adpopcorn.pluslock.IgawPlusLockReceiver">
	<intent-filter>
                <action android:name="android.intent.action.BOOT_COMPLETED"/>
         </intent-filter>
         <intent-filter>
                <action android:name="android.intent.action.PACKAGE_ADDED"/>
                <action android:name="android.intent.action.PACKAGE_REPLACED"/>
                <data android:scheme="package" />
         </intent-filter>
</receiver>

注意!!!
上述内容仅在 PlusLock SDK 集成时，进行设置。
未集成 SDK 的情况下进行设置时，会发生应用崩溃等类似的问题。

激活 PlusLock

PlusLock 激活功能包含在 adPOPcorn 积分墙内。因此首先需完成 [adPOPcorn 积分墙 : Android] 。

完成积分墙集成和 PlusLock 的 Android Manifest 设置结束后，进入积分墙时可以查看到以下设置画面。

PlusLock 为 ON 时，可以激活 PlusLock 锁屏画面。

奖励服务器集成及验收

在应用中曝光 PlusLock 的集成部分结束之后，为了向积分达到标准的用户支付奖励，需进行集成奖励服务器。

为了向完成积分墙广告参与的用户支付奖励也必须集成奖励服务器。参考以下文件集成奖励服务器。

[IGAW 奖励服务器集成指南]

完成奖励服务器集成后，进行广告测试，确认广告参与和奖励是否正常，确认之后申请验收。

使用 adPOPcorn 积分墙服务必须通过验收，通过 adPOPcorn 管理页面的验收申请功能，提交 APK。

验收咨询 : china@igaworks.com / QA@igaworks.com

自定义 API : Android

提供 PlusLock event 和 action 的自定义 API。

IgawPlusLock_v1.0.1 版本以上提供自定义 API 功能。

1. 查看 PlusLock 状态

使用 IsActivateLockScreen API，可以查看 PlusLock 的 on/off 状态。

PlusLock 处于 OFF 状态时，可以定义动作来引导用户设置为 ON。

bool isActivePlusLockScreen = IgawPlusLock.IsActiveLockScreen(MainActivity.this);
// isActivePlusLockScreen : 
//     true : Screen ON
//     false : Screen OFF

2. 手动调整 PlusLock ON/OFF 状态

使用 activateLockScreen API，在代码上可以直接设置 PlusLock ON/OFF 状态。

并且使用 IPlusLockResultCallback Listener 返回 ON/OFF 的处理结果。使用接收的信息可以激活或关闭 PlusLock 服务。

注意!!!
手动调用 ON/OFF API 之前，必须首先调用 setUserId API (输入用户识别码)。
不然无法正常参与广告。

1. 激活 PlusLock (OFF ->ON)

IgawPlusLock.activateLockScreen(MainActivity.this, true, iplusLockResultCallback);

2. 关闭 PlusLock (ON -> OFF)

IgawPlusLock.activateLockScreen(MainActivity.this, false, iplusLockResultCallback);

3. 实现 IPlusLockResultCallback Listener

根据设置 ON, OFF 的结果，处理激活或关闭PlusLock服务。

IgawPlusLock.activateLockScreen(context, activate, new IPlusLockResultCallback(){
@Override
	public void onResult(ResultModel rm) {
	// TODO Auto-generated method stub					
		if(rm != null && rm.isResult()){ //向服务器申请的结果为true时，结果处理
			if(activate) // 成功 On 时，开始服务。	
				IgawPlusLock.startLockScreenService(context);				
			else // 成功 OFF 时，服务结束。	
				IgawPlusLock.stopLockScreenService(context);				
		}
			else{ // 向服务器申请失败时，输出通知信息。
				if(activate)
					Log.d("启动 PlusLock 失败。请稍后再试。");	
				else
					Log.d("关闭 PlusLock 失败。请稍后再试");	
		}		
    }
});

3. 查询 PlusLock 积分

使用 getPlusLockSaveHistory API，可以查询解除 PlusLock 锁屏时获取的积分。

通过 IPlusLockRewardHistoryCallback 传达结果，此结果参考 RewardHistoryModel。 IgawPlusLock.getPlusLockSavedHistory(context, new IPlusLockRewardHistoryCallback(){

@Override
	public void onResult(RewardHistoryModel historyModel) {
		// TODO Auto-generated method stub
		if(historyModel != null){
			if(historyModel.getPoint() != null)
				pointTv.setText(historyModel.getPoint() + "");
			}			
		}				
	}
);

4. 同公司推送 ICON

登录同公司的推送功能时，可以变更推送设置。

setSmallIconResId : 变更通知ICON알림 아이콘 변경
setSmallIconBgColor : 变更通知ICON背景

IgawPlusLockNotificationManager.setSmallIconResId(context, R.drawable.icon);
IgawPlusLockNotificationManager.setSmallIconBgColor(context, 0xff123456);