文档

接入 SDK

更新时间:

将内容中台 SDK 接入到 Android 客户端并使用 SDK 功能。当前仅支持 mPaaS 原生 AAR 接入方式,更多内容参见 接入方式介绍

整个流程主要分为三步:

  1. 创建工程

  2. 添加 SDK

  3. 使用 SDK

创建工程

打开 IDE Android Studio,创建一个工程。如要下载安装 Android Studio,请前往 Android Studio 官方网页

image.png

添加 SDK

  1. 添加自定义基线 cp_change_33135.2。

    说明

    内容中台 SDK 接入测试仅在 cp_change_33135 的自定义基线版本中提供。

    1. 在 IDE 中,单击 mPaaS > 原生 AAR 接入,在弹出的接入面板中,单击 接入/升级基线 > 开始配置

    2. 在基线升级对话框中勾选 自定义基线, 并输入定制基线 ID“cp_change_33135.2”。

  2. 添加内容中台组件到项目中。

    1. 在 mPaaS 配置面板中,单击 配置/更新组件 > 开始配置

    2. mPaaS 组件管理 窗口中,勾选内容中台组件,如下图所示。

      13
  3. build.gradle 文件中添加依赖引入 SDK。

    implementation 'com.github.bumptech.glide:glide:4.12.0'
    annotationProcessor 'com.github.bumptech.glide:compiler:4.12.0'

使用 SDK

  1. 初始化 SDK。在 onCreate 中执行初始化方法。

    public class MainApplication extends Application {
        @Override
        public void onCreate() {
            super.onCreate();
            //需要用户设置当前UserId,如下:
            String userId = "mPaaSTest";
            MPContent.getInstance().init(this, userId, MPContent.FeedType.MPContent_SingleListFeed);
        }
    }
  2. 调用 SDK Feed 流接口。

    View view = MPContent.getInstance().createFeedListView(this);

    调用 createFeedListView 接口会返回一个 View。可以通过 addView 方法自定义 View,如下所示:

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
    
        View view = MPContent.getInstance().createFeedListView(this);
        LinearLayout linearLayout = findViewById(R.id.ll_layout);
        linearLayout.addView(view);
    }

    退出页面时需要调用 removeView 方法清除 View。

    @Override
    protected void onDestroy() {
        super.onDestroy();
        if (view != null) {
            linearLayout.removeView(view);
        }
    }
    • Feed 流页面插入自定义 View

      在 Feed流中,插入自定义的广告位。

      重要

      随机插入 View 的接口调用须在 createFeedListView 接口调用之前。

      LayoutInflater inflater = LayoutInflater.from(getApplicationContext());
      View itemRandomView = inflater.inflate(R.layout.layout_custom, null);
      TextView textView = itemRandomView.findViewById(R.id.feed_user_add);
      
      textView.setOnClickListener(new View.OnClickListener() {
          @Override
          public void onClick(View v) {
              Toast.makeText(MainActivity.this, "用户返回View", Toast.LENGTH_SHORT).show();
          }
      });
      MPContent.getInstance().setCustomFeedItemADView(1, itemRandomView);
    • 设置图文详情页的自定义 View 插入

      在图文详情页的指定位置插入自定义 View。

      LayoutInflater inflater = LayoutInflater.from(getApplicationContext());
      View inflates = inflater.inflate(R.layout.layout_footview, null);
      ImageView viewById = inflates.findViewById(R.id.sss);
      viewById.setOnClickListener(new View.OnClickListener() {
      @Override
      public void onClick(View v) {
          Toast.makeText(MainActivity.this, "用户返回View", Toast.LENGTH_SHORT).show();
      
      }
      });
      MPContent.getInstance().setCustomDetailADView("123", inflates);
    • 视频详情页推荐产品列表点击回调

      在用户点击视频详情页上的产品时实现回调。

      MPContent.getInstance().setJumpDetailsListener(new JumpListener() {
          @Override
          public void onJump(CommodityBean commodityBean) {
              
              //commodityBean 回到返回数据,根据用户定义
          }
      });
      
    • 点赞未登录回调

      点赞未登录时进行回调。用户需要在登录后才能进行点赞操作。

      MPContent.getInstance().setNoLoginListener(new NoLoginListener() {
          @Override
          public void onJump2Login(CommodityBean commodityBean) {
             //返回用户自己定义登录
          }
      });
      
    • 设置视频是否自动播放

      /**
       * true 自动播放;false 点击播放
       */
      MPContent.getInstance().setAutoPlay(false);

  • 本页导读 (0)