基础进阶

更新时间:2021-05-25

概述

本文主要介绍了 SDK 的进阶功能,包括 金融、分享,推送、数据埋点等相关的处理。

进阶使用

金融系统

1. 订单充值回调

想要使用充值和送礼等金融功能,需要打通 SDK 和接入方的金融系统。

SDK提供了一个回调代理,点击 SDK 中充值按钮,SDK 会 生成订单号,然后会把订单号通过 onBuyGoldWithOrderId 回调方法通知代理。

charge

回调方法
/**
    * activity              activity
    * source                order type
    * requestCode           recharge status
    * orderId               orderId
    */
public void onBuyGoldWithOrderId(Activity activity,int source,int requestCode,String orderId);

2. 获取当前用户的金币余额

/**
  * Get the current user's gold coin balance
  * @param goldBalanceCallback: goldBalanceCallback  Callback interface
  * @param status  status
  * @param error  error msg
  * @param goldBalance  gold coin balance
  * void onResult(int status, String error, int goldBalance);
  */
LinkliveSDK.getInstance().queryGoldBalance(goldBalanceCallback);

3. 刷新当前金币数

一般在接入方充值成功之后调用,传入当前用户当时的金币数量

/** Refresh the current number of gold coins
  * @param current_gold Current number of gold coins
  */
LinkliveSDK.getInstance().refreshCurrentGold(int current_gold);

分享功能

SDK 支持分享功能,SDK 提供分享所需要的数据,分享功能需要在接入方客户端进行实现 shareWithContent 代理方法完成分享。

回调方法

  • 接入方实现此回调方法,在此回调方法中实现分享功能。
/**
 * 分享代理回调方法
 * @param activity                  activity
 * @param linkliveShareInfo         Sharing data examples
 * @param iShareCallback            Sharing status callback
 **/
public void shareWithContent(Activity activity, LinkliveShareInfo linkliveShareInfo, IShareCallback iShareCallback);

分享数据

LinkliveShareInfo

public class LinkliveShareInfo {
    // 媒体id
    private String videoId;

    // 主播名字
    private String userName;

    // 资源类型, 1: live room 2: h5
    private int source;

    // 标题
    private String title;

    // 内容
    private String content;

    // 链接url
    private String url;

    // 播主头像
    private String captureUrl;

    // 类型,1:分享来自于其他人,2:分享来自于自己
    private int type;
}

推送功能

SDK 提供自定义推送功能,需要由 我方服务端 调用 接入方服务端 实现相关推送,可实现主播开播提示发送通知,点击通知栏进入直播间,私信消息通知等功能。可具体联系 LinkV 商务人员,进行了解对接推送功能。

调用示例

接入方客户端收到推送的 url 后,触发 routeWithURI 方法,打开直播间。

LinkliveSDK.getInstance().routeWithUri(getContext(), path);

数据埋点

SDK 目前已经通过代理方法 onDataTrack 对一些关键的数据回调给接入方,接入方可以针对数据做埋点统计等。

回调方法

/**
 * Data buried point
 * @param kewlDataTrackModel     Data buried point model
 **/
public void onDataTrack(KEWLDataTrackModel kewlDataTrackModel);

透传数据埋点类型

//透传数据模型
public class KEWLDataTrackModel {

    // 看播
    public static final int DataTrackActiveWatchLive = 1;
    
    // 送礼
    public static final int DataTrackActiveSendGift = 2;
    
    // 关注
    public static final int DataTrackActiveFollow = 3;
    
    // 首页tab点击
    public static final int DataTrackActiveTabClick = 4;
    
    // 排行榜点击
    public static final int DataTrackActiveRankClick = 5;
    
    // 使用滤镜
    public static final int DataTrackActiveUseFilter = 6;
    
    // 点击开播按钮
    public static final int DataTrackActiveLiveClick = 7;
    
    // 开播权限授权状态
    public static final int DataTrackActiveRequestPermission = 8;
    
    // 开始直播
    public static final int DataTrackActiveStartLive = 9;
    
    // 主播分享直播
    public static final int DataTrackActiveBroadCasterShare = 10;
    
    // 成功修改个人信息
    public static final int DataTrackActiveProfileModifySucc = 11;
    
    // 拉流成功
    public static final int DataTrackActivePullStreamSucc = 12;
    
    // 发送评论
    public static final int DataTrackActiveSendComment = 13;
    
    // 点击礼物面板
    public static final int DataTrackActiveGiftPanelClick = 14;
    
    // 送礼成功
    public static final int DataTrackActiveSendGiftSucc = 15;
    
    // 观众分享直播
    public static final int DataTrackActiveCustomerShare = 16;
    
    // 榜单页点击关注
    public static final int DataTrackActiveRankPageFollowClick=17;
}

透传数据模型类

public class KEWLDataTrackModel {

    // required
    // 上报类型
    public int type;
    
    // 用户id
    public String uid;
    
    // 用户区域
    public String user_area;

    // Watch Live
    // 直播id
    public String watch_live_video_vid;
    
    // 主播昵称
    public String watch_live_broadcaster_nick_name;
    
    // 主播性别
    public String watch_live_broadcaster_gender;
    
    // 主播年龄
    public String watch_live_broadcaster_age;

    // Send Gift
    // 礼物id
    public String send_gift_id;
    
    // 礼物价格
    public String send_gift_price;

    // Follow/UnFollow
    // follow状态,(关注还是取消关注)
    public boolean follow_is_follow;
    
    // 被关注性别
    public String follow_followers_gender;
    
    // 被关注年龄
    public String follow_followers_age;

    // 拉流的流id
    public String pull_stream_succ_vid;
    
    // 评论id
    public String send_comment_vid;
    
    // 礼物面板点击的礼物id
    public String panel_click_vid;
    
    // 成功送出的礼物id
    public String send_gift_succ_gift_id;
    
    // 成功送礼的直播id
    public String send_gift_succ_vid;
    
    // 被观众分享的直播id
    public String customer_share_vid;

    // Tab Click
    // 被点击的tab名字
    public String tab_click_tab_name;

    // User Filter
    // 滤镜名字
    public String use_filter_filter_name;

    // Request Permission
    // request_permission_per_type = 1 Camera
    // request_permission_per_type = 2 Micro
    // 权限类型(摄像头,麦克风)
    public String request_permission_per_type;

    // Rank Page Follow Click
    // 榜单页面点击关注还是取消关注
    public boolean rank_page_follow_click_follow_status;
    
    // 榜单中被关注的uid
    public String rank_page_follow_click_follow_uid;
}