• 最低支持版本为Android 4.0 (API level 15)
• 支持的cpu架构：armv7, arm64, x86

软硬编部分功能版本需求列表:

	软编
基础推流	4.0 (15)
网络自适应	4.0 (15)

• 将ppcloud-sdk.aar拷贝到app的libs目录下；
• 修改目标工程的build.gradle文件，配置repositories路径：

repositories {
    flatDir {
        dirs 'libs'
    }
}
dependencies {
    ...
    compile(name: 'ppcloud-sdk', ext: 'aar')
    ...
}
                                

• 初始化SDK

  
  // 在app的application里调用初始化函数
  PPYSdk.getInstance().init(this);
  public class TestApplication extends Application {
      @Override
      public void onCreate(){
          super.onCreate();
          PPYSdk.getInstance().init(this);
      }
  }
                                          

  具体可参考demo工程中的LiveStreamingActivity类

• 在布局文件中加入预览View

  <com.pplive.ppysdk.PPYLiveView
          android:id="@+id/lsq_cameraView"
          android:layout_width="match_parent"
          android:layout_height="match_parent" >
          </com.pplive.ppysdk.PPYLiveView >
                                          

• PPYLiveView

  
  PPYLiveView mCameraView;
  mCameraView = (PPYLiveView)findViewById(R.id.lsq_cameraView);
                                          

• 创建并配置PPYStreamerConfig。 推流过程中不可动态改变的参数需要在创建该类的对象时指定。

  
  PPYStreamerConfig builder = new PPYStreamerConfig(); // use default param
  // 设置推流url
  builder.setPublishurl(url);
  /**
   * 设置推流分辨率，支持以下值：
   * VIDEO_RESOLUTION_TYPE.VIDEO_RESOLUTION_360P,
   * VIDEO_RESOLUTION_TYPE.VIDEO_RESOLUTION_480P,
   * VIDEO_RESOLUTION_TYPE.VIDEO_RESOLUTION_540P,
   * VIDEO_RESOLUTION_TYPE.VIDEO_RESOLUTION_720P;
   */
  builder.setVideoResolution(VIDEO_RESOLUTION_TYPE.VIDEO_RESOLUTION_480P);
  // 设置视频帧率
  builder.setFrameRate(15);
  // 设置视频码率(分别初始码率, 单位为kbps)
  builder.setVideoBitrate(400);
  // 设置音频码率(单位为kbps)
  builder.setAudioBitrate(32);
  // 设置音频采样率
  builder.setSampleAudioRateInHz(44100);
  // 设置是否默认使用前置摄像头
  builder.setDefaultFront(true);
  // 设置是否采用横屏模式
  builder.setDefaultLandscape(false);
                                          

• 创建PPYStreame对象

  
  PPYStream mPPYStream = new PPYStream();
  mPPYStream.CreateStream(getApplicationContext(), config, mCameraView);
  mPPYStream.setPPYStatusListener(new PPYStatusListener() {
      @Override
      public void onStateChanged(int type, Object o) {
          if (type == PPY_SDK_INIT_SUCC)
              mPPYStream.StartStream();
      }
  });
                                          

• 创建推流事件监听，可以收到推流过程中的异步事件。

  注意：所有回调直接运行在产生事件的各工作线程中，不要在该回调中做任何耗时的操作，或者直接调用推流API。

  
  mPPYStream.setPPYStatusListener(new PPYStatusListener() {
      @Override
      public void onStateChanged(int type, Object o) {
          if (type == PPY_SDK_INIT_SUCC)
              mPPYStream.StartStream();
      }
  });
                                          

• 开始推流

  注意：初次开启预览后需要在setPPYStatusListener回调中收到PPY_SDK_INIT_SUCC 事件后调用方才有效。

  
  mPPYStream.StartStream();
                                          

• 推流过程中可动态设置的常用方法

  
  / 切换前后摄像头
  mPPYStream.SwitchCamera();
  // 开关闪光灯
  mPPYStream.setFlashLightState(true);
  // 是否支持打开闪光灯
  mPPYStream.IsSupportFlashlight();
  // 设置是否开启美颜
  mPPYStream.EnableBeauty(true);
  // 设置美颜的美白，亮度，色调参数(0-1.0 默认都是0.5)
  mPPYStream.SetBeautyParam(mBeautyWhite, mBeautyBright, mBeautyTone);
  
  //推流过程中获取音视频信息
  // 获取当前视频宽高
  mPPYStream.getVideoWdith();
  mPPYStream.getVideoHeight();
  // 获取当前视频码率
  mPPYStream.getVideoBitrate();
  // 获取当前音频码率
  mPPYStream.getAudioBitrate();
  // 获取当前FPS
  mPPYStream.getVideoFrameRate();
                                          

• 停止推流

  
  mPPYStream.StopStream();
                                          

• Activity的生命周期回调处理

  采集的状态依赖于Activity的生命周期，所以必须在Activity的生命周期中也调用SDK相应的接口。

  
   public class LiveStreamingActivity extends Activity {
      // ...
      @Override
      public void onResume() {
          super.onResume();
          mPPYStream.OnResume();
      }
      @Override
      public void onPause() {
          super.onPause();
          mPPYStream.OnPause();
      }
      @Override
      public void onDestroy() {
          super.onDestroy();
          mPPYStream.OnDestroy();
      }
  }
                                          

如需测试用的推流地址，请联系我们。