Android : 通用传视集成文档(java,AS)

请以Conviva开发者社区作为主要参考源。

集成之前,请前往官网下载对应播放器类型的Demo,参考进行集成。

一 下载SDK

如果在Conviva开发者社区存在要集成的播放器类型,需要下载Conviva_SDK_Android和播放器对应的SDK(下面称为proxy);如果没有,只下载Conviva_SDK_Android,参考《Android自定义播放器集成文档》自己写一个proxy类。

二 集成步骤

• 导入SDK

Conviva_SDK_Android和对应播放器SDK复制到工程的app下libs文件夹中,右键SDK-----Add As Library。找到Demo的helper文件夹,复制ConvivaSessionManager文件到项目中合适位置。

• 使用SDK

1.在ConvivaSessionManager中替换customerKey

2.初始化SDK,app启动第一次调用即可,可以写在Application,测试阶段的mGateWayUrl一般是https://testonly.conviva.com或ClientSettings.defaultDevelpomentGatewayUrl,测试没问题替换成pulse的url。

ConvivaSessionManager.initClient(this, mGateWayUrl);

3.创建Session。表示对一段视频检测的开始(位置在播放器开始请求视频数据之前即可,进行到这一步Touchstone就会有数据的,尽管可能状态不准确)。

//mStateManager需要在createSession和创建Proxy之前实例化

mStateManager = ConvivaSessionManager.getPlayerManager();

//创建Session

ConvivaSessionManager.createConvivaSession(videoUri.toString);

4.创建Proxy对象,该类是每个播放器独有的,比如MediaPlayer是CVMediaplayerInterface。这个过程是对视频的状态开始监听。Proxy对象需要在mStateManagermPlayer不为null的地方进行实例化。

//创建proxy对象,传递的参数是PlayerStateManager和播放器Player对象。

mPlayerInterface = new CVMediaPlaterInterface(mStateManager,mPlayer);

5.对广告,比特率,分辨率,自定义错误,自定义事件,配置元数据的操作。(可选)

A:在广告的监听中设置:

//广告开始

ConvivaSessionManager.adStart();

//广告开始自定义事件(可选,作为广告开始的补充,可传递一些信息)

ConvivaSessionManager.podEvent(ConvivaSessionManager.POS_EVENT_POD_START);

//广告结束

ConvivaSessionManager.adEnd();

//广告结束自定义事件(可选,作为广告结束的补充,可传递一些信息)

ConvivaSessionManager.podEvent(ConvivaSessionManager.POS_EVENT_POD_END);

B:在可监测比特率变化的监听中设置:

mPlayeStateManager.setBitrateKbps(…);

C:在系统检测不到的错误,需要自定义的时候调用:

mPlayeStateManager.sendError(…);

D:在分辨率变化的监听中设置:          

mPlayeStateManager.setVideoWidth(…);

mPlayeStateManager.setVideoHeight(…);

E:Demo中元数据的配置在ConvivaSessionManager文件中依赖于ContentMetadata,可以按需求置于合适位置。

6. 销毁Session,表示对一段视频的检测结束。一般是在back退出时或进入下个视频等结束该视频时调用releasePlayer()。复制Demo-playerActivity的下面代码到player:

private void releasePlayer() {

    if (mPlayer != null) {

        releaseAnalytics();

    }

}


private void releaseAnalytics() {

    if (mPlayer != null) {

        if (mPlayerInterface != null) {

            mPlayerInterface.cleanup();

            mPlayerInterface = null;

        }

        ConvivaSessionManager.releasePlayerStateManager();

        ConvivaSessionManager.cleanupConvivaSession();

    }

}

7. 释放Client,退出app时调用即可

ConvivaSessionManager.deinitClient();

• 测试

完成上述步骤,conviva对视频的检测就开始了,详细测试步骤参见《TouchStone的使用及测试流程》

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 200,667评论 5 472
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 84,361评论 2 377
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 147,700评论 0 333
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,027评论 1 272
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 62,988评论 5 361
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,230评论 1 277
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,705评论 3 393
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,366评论 0 255
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,496评论 1 294
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,405评论 2 317
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,453评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,126评论 3 315
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,725评论 3 303
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,803评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,015评论 1 255
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,514评论 2 346
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,111评论 2 341

推荐阅读更多精彩内容