Android SDK集成

// Application
public void onCreate() {
		// Finder SDK 不需要区分进程，务必在多个进程都初始化
    initAppLog();
    // 弹窗、资源位 SDK 初始化只需要在主进程初始化既可—— 2.1.0.5-bugfix 及以上内部已经判断，外部可不需要判断
    if (ToolUtils.isMainProcess(this)) {
	      // 生成触达相关的配置（必选）
	      ReachConfig reachConfig = initReachConfig();
	      // 初始化 弹窗SDK
	      initGMPPopSDK(reachConfig);
    }
}

private ReachConfig initReachConfig() {
		return new ReachConfig.Builder()
				// 设置 gmp 项目id
        .setAppId(Config.INSTANCE.getGmpAppId())
        .setAppConfig(new IAppConfig() {
		         @NonNull
		         @Override
		         public String getHost() {
				         // 设置 GMP 的域名
		             return Config.INSTANCE.getGmpHost();
		         }
        })
        // 如果项目支持自动登录,用户画像已经存在,需要提前设置上
        .setUniqueUid(uuid)
        .setUniqueUidType(uuidType)
        //用于图片类型的加载，可以根据接口说明自行选择图片加载库；SDK版本 >= 2.1.1 已经废除，无须实现
        .setImageConfig(MyImageConfig.INSTANCE.getMyImageConfig())
        .build();
}


private void initGMPPopSDK(ReachConfig reachConfig) {
    //初始化弹窗sdk
    GMPPopupSDK.INSTANCE.initPopup(this, new PopupConfig.Builder()
            .setReachConfig(reachConfig)
            // 设置 GMP 弹窗id
            .setPopupAppId(Config.INSTANCE.getGmpPopupAppId())
            .build()
      );
}

//Application
public void onCreate() {
		// Finder SDK 不需要区分进程，务必在多个进程都初始化
	  initAppLog();
    // 弹窗、资源位 SDK 初始化只需要在主进程初始化既可 —— 2.1.0.5-bugfix 及以上内部已经判断，外部可不需要判断
    if (ToolUtils.isMainProcess(this)) {
	      // 生成触达相关的配置（必选）
	      ReachConfig reachConfig = initReachConfigSaas();
	      // 初始化 弹窗SDK
	      initGMPPopSDK(reachConfig);
    }
}

private ReachConfig initReachConfigSaas() {
    // 生成触达相关的配置（必选）
    return new ReachConfig.Builder()
            // 设置 gmp 项目id
            .setAppId(Config.INSTANCE.getGmpAppId())
            .setAppConfig(new IAppConfig() {
                @NonNull
                @Override
                public String getHost() {
                    // 设置 gmp saas 的域名
                    return "https://gmp-saas-api.console.volcengine.com";
                }
            })
            // 设置 gmp 主账号id
            .setMainAccountId(Config.INSTANCE.getGmpMainAccountId())
            // 如果项目支持自动登录,用户画像已经存在,需要提前设置上
		        .setUniqueUid(uuid)
		        .setUniqueUidType(uuidType)
            //用于图片类型的加载，可以根据接口说明自行选择图片加载库；SDK版本 >= 2.1.1 已经废除，无须实现
            .setImageConfig(MyImageConfig.INSTANCE.getMyImageConfig())
            .build();
}

private void initGMPPopSDK(ReachConfig reachConfig) {
    //初始化弹窗sdk
    GMPPopupSDK.INSTANCE.initPopup(this, new PopupConfig.Builder()
            .setReachConfig(reachConfig)
            // 设置 GMP 弹窗id
            .setPopupAppId(Config.INSTANCE.getGmpPopupAppId())
            .build()
      );
}

// 实现接口 IImageConfig
public class FrescoImageConfigJava implements IImageConfig {
    @Override
    public boolean isInMemoryOrDiskCache(Uri uri) {
        ImagePipeline imagePipeline = Fresco.getImagePipeline();
        return imagePipeline.isInBitmapMemoryCache(uri) || imagePipeline.isInDiskCacheSync(uri);
    }

    @Override
    public void getImage(int viewWidth, int viewHeight, String url, IImageListener imageListener) {
        ImageRequest imageRequest = ImageRequest.fromUri(Uri.parse(url));
        DataSource<CloseableReference<CloseableImage>> dataSource = Fresco.getImagePipeline().fetchDecodedImage(imageRequest, null);
        dataSource.subscribe(new BaseBitmapDataSubscriber() {
            @Override
            protected void onNewResultImpl(@Nullable Bitmap bitmap) {
                if (bitmap == null) {
                    imageListener.onFail(new Throwable("bitmap empty"));
                    return;
                }
                float scaleSize = getScaleSize(bitmap, viewWidth, viewHeight);
                imageListener.onSucceed(Bitmap.createScaledBitmap(bitmap, (int) (bitmap.getWidth() / scaleSize), (int) (bitmap.getHeight() / scaleSize), false));
            }

            @Override
            protected void onFailureImpl(DataSource<CloseableReference<CloseableImage>> dataSource) {
                imageListener.onFail(dataSource.getFailureCause());
            }
        }, CallerThreadExecutor.getInstance());
    }

    @Override
    public void preloadImage(String url) {
        if (url.isEmpty() || isDownloaded(Uri.parse(url))) {
            return;
        }
        ImageRequest imageRequest = ImageRequest.fromUri(Uri.parse(url));
        Fresco.getImagePipeline().prefetchToDiskCache(imageRequest, null);
    }

    private float getScaleSize(Bitmap bitmap, int viewWidth, int viewHeight) {
        float scaleWidth = bitmap.getWidth() / (viewWidth * 1.0f);
        float scaleHeight = bitmap.getHeight() / (viewHeight * 1.0f);
        return Math.max(scaleWidth, scaleHeight);
    }

    private boolean isDownloaded(Uri uri) {
        ImageRequest imageRequest = ImageRequest.fromUri(uri);
        if (imageRequest == null) {
            return false;
        }
        CacheKey cacheKey = Fresco.getImagePipeline().getCacheKeyFactory()
                .getEncodedCacheKey(imageRequest, null);
        return ImagePipelineFactory.getInstance()
                .getMainFileCache().hasKey(cacheKey);
    }
}

private ReachConfig initReachConfig() {
		FinderInitConfig finderConfig = new FinderInitConfig.Builder()
								// 设置自动更新为关闭
                .setAutoUpdateUser(false)
                .build();
		return new ReachConfig.Builder()
				// ...省略其他配置...
				// 关闭自动更新
				.setFinderInitConfig(finderConfig)
        .build();
}

// 手动更新用户画像,需要在合适的时机及时调用,如账号切换
// 更新弹窗SDK用户画像，务必在 AppLog.setUserUniqueID 设置前调用   
GMPPopupSDK.INSTANCE.updateUUid(Config.INSTANCE.getGmpUuid(),Config.INSTANCE.getGmpUuIdType());
// 更新 FinderSDK uuid
AppLog.setUserUniqueID(Config.INSTANCE.getGmpUuid(), Config.INSTANCE.getGmpUuIdType());

// 更新弹窗SDK用户画像，务必在 AppLog.setUserUniqueID 设置前调用   
GMPPopupSDK.INSTANCE.updateUUid("","");
// 更新 FinderSDK uuid
AppLog.setUserUniqueID(null,null);

// 在 initGMPPopSDK 之后设置
private void setGMPPopWindowStatusListener() {
    GMPPopupSDK.INSTANCE.setPopupWindowStatusListener(new PopupWindowStatusListener() {

        /**
         * 弹窗展示时回调
         * @param popupWindowControl GMP弹窗控制接口 // SDK >= 2.1.2 增加
         */
        @Override
        public void onPopupWindowShow(IPopupWindowControl popupControl) {
        }

        /**
         * 弹窗关闭时回调
         */
        @Override
        public void onPopupWindowDismiss() {

        }

        /**
         * 弹窗中配置了跳转链接的按钮/图片被点击且拦截了弹窗的点击事件时回调
         * 只有当 interceptPopupWindowClick 返回为 true 时回调
         * @param url 点击的内容
         */
        @Override
        public void onPopupWindowClick(@NonNull String url) {

        }

        /**
         * 是否拦截弹窗的点击事件
         * @param url 点击的内容
         * @return 返回值为true代表由接入方处理跳转逻辑
         *  为false则会由sdk启动内嵌h5页处理跳转逻辑(必须是http开头的链接)
         */
        @Override
        public boolean interceptPopupWindowClick(@NonNull String url) {
            return false;
        }

				/**
				 * SDK 版本 >= 2.1.1 才存在
				 * 准备触达弹窗:真实弹窗的之前会回调该接口
				 * @return true 表示准备好了，触达即将开始，弹出弹窗；false 表示不进行触达，不弹出
				 */
				@Override
				public boolean popupWindowShouldShow() {
				    return true;
				}

				
        /**
	       * SDK 版本 >= 2.1.2 才存在
		     * 弹窗前解析自定义规则,配置了自定义规则才会回调到这个接口
		     * 回调在子线程
		     * @param json 透传json 可能为null
		     * @param callback 可以弹窗回调true，否则回调false。
		     */
		     @Override
		    public void popupWindowShowJudgeFromClient( @Nullable JSONObject json, ClientRuleStrategyCallback callback) {
		        // 如果本地不处理json内容，回调 true 即可
		        callback.showPopupWindow(true);
		        // 需要处理json示例
		        /**
		        if( json != null || json 解析，并且可以处理 ) {
		            // 网络请求、本地判断等操作 之后
		            if(可以弹窗) {
		                callback.showPopupWindow(true);
		            }else{
		                callback.showPopupWindow(false);
		            }
		        }else{
		            // 不能进行弹窗
		            callback.showPopupWindow(false);
		        }
		         **/
		    }
		    });
}

GMPPopupSDK.INSTANCE.removePopupWindowStatusListener();

GMPPopupSDK.INSTANCE.preViewPopupWindow("windowId");

// enablePopup 是否禁用弹窗
// closeShowingPopupWindow 是否关闭正在显示的弹窗,默认为false(enablePopup为false才生效)
GMPPopupSDK.INSTANCE.setPopupEnableStatus(enablePopup,closeShowingPopupWindow);

GMPPopupSDK.INSTANCE.setPopupImagePreLoadLevel(ImagePreLoadLevel.ALL);

// 默认可加载的图片格式
List<String> DEFAULT_IMAGE_FORMAT = Arrays.asList("gif", "png", "jpg", "jpeg", "webp", "svp", "psd", "bmp", "tif");

// 如需修改可在初始化时设置imageFormat
GMPPopupSDK.INSTANCE.initPopup(this,
        new PopupConfig.Builder()
                .setReachConfig(reachConfig)
                // 设置 GMP 弹窗id
                .setPopupAppId(Config.INSTANCE.getGmpPopupAppId())
                // 可选: 设置允许预加载的图片格式
                .setImageFormatList(DEFAULT_IMAGE_FORMAT)
                .build()
);

// 如需修改可在初始化时设置imageFormat
GMPPopupSDK.INSTANCE.initPopup(this,
        new PopupConfig.Builder()
                 // 省略其他配置.....
				         // 设置开启弹窗补偿
				        .setEnablePopupCompensate(true)
                .build()
);

GMPPopupSDK.INSTANCE.initPopup(this,
        new PopupConfig.Builder()
                 // 省略其他配置.....
				         // 设置轮询间隔, 单位秒 , 小于等于0 不轮询 , 内部默认轮询间隔 300s
				        .setPollingInterval(600)
                .build()
);

new ReachConfig.Builder()
        // 省略其他配置.....
        // 接口实现参考例子，请按照项目中实际配置
        // 设置线程调度策略 , 可以配置项目自己的线程池 , 防止后台过多线程执行
        .setThreadConfig(new IThreadConfig() {
            @NonNull
            @Override
            public Handler getMainHandler() {
                return new Handler(Looper.getMainLooper());
            }

            @NonNull
            @Override
            public Handler getBackgroundHandler() {
                HandlerThread ht = new HandlerThread("BackgroundHandler");
                ht.start();
                return new Handler(ht.getLooper());
            }
        })
        .build();

new ReachConfig.Builder()
        // 省略其他配置.....
        // 设置项目用到的 uba 系统, 默认接入为 finder
        .setUbaConfig(new IUBAConfig() {
            @NonNull
            @Override
            public String getDid() {
                return "";
            }

            @NonNull
            @Override
            public String getBaseId() {
                return "";
            }

            @Override
            public void onEvent(@NonNull String s, @NonNull JSONObject jsonObject) {

            }

            @Nullable
            @Override
            public <T> T getABConfig(@NonNull String s, T t) {
                return null;
            }

            @Nullable
            @Override
            public JSONObject getUbaCommonParams() {
                return null;
            }
        })
        // 设置 debug 输出日志
        .debug(true)
        .build();

GMPPopupSDK.INSTANCE.reportEventForPopupWindow("eventName" , new JSONObject());

GMPPopupSDK.INSTANCE.closeShowingPopupWindow();

JSONObject body = new JSONObject();
body.put("param_name_1", "param_value_1");
body.put("param_name_2", "param_value_2");
// ......
AppLog.onEventV3(eventName, body);

GMPPopupSDK.INSTANCE.reportEventForPopupWindow("eventName" ,new JSONObject());