Android SDK

手机推流Android SDK文档

目录

1. 如何接入
2. 推流步骤
3. 拉流步骤
4. 错误码说明
5. 添加混淆文件
6. SDK和Demo下载

如何接入

环境需求:

• JDK版本1.8
• Android SDK API Level ≥ 18
• App要求 Android 4.3及以上设备
• cpu架构支持 ARM、ARMV7、ARM64

接入步骤:

1. 将yagupusher.aar、yaguplayer.aar全部拖入app目录下的libs文件夹中。
2. 在build.gradle中的dependencies下修改如下代码后同步工程:

implementation fileTree(dir: 'libs', include: ['*.jar', '*.aar'])

1. 下AndroidManifest文件下添加如下权限代码:

<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WAKE_LOCK" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />

说明： 请您务必注意添加录音权限和相机权限。

推流步骤

1.创建surfaceView

mSurfaceView = new YaguGLSurfaceView(this);
RelativeLayout.LayoutParams surfaceView_layoutParams = new RelativeLayout.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.MATCH_PARENT);

mSurfaceView.setLayoutParams(surfaceView_layoutParams);
mSurfaceView.setIsRemoveOrAdd(true);
mSurfaceContainer.addView(mSurfaceView);
mSurfaceHolder = mSurfaceView.getHolder(); // 绑定SurfaceView，取得SurfaceHolder对象
mSurfaceHolder.addCallback(this);
mSurfaceView.setPreserveEGLContextOnPause(true);
mSurfaceView.setOnTouchListener(this);
mSurfaceView.setKeepScreenOn(true);

2.初始化推流引擎

mEngine = new YaguLiveEngine_Ex(mSurfaceView, this, mEngine_Type, mBeauty_Type,true);
mEngine.init(this, mEngine_Type);
mEngine.setLog(true);

3.开启预览

//屏幕方向，竖屏|横屏
int rotation = ((WindowManager)this.getSystemService(Context.WINDOW_SERVICE)).getDefaultDisplay().getRotation();
mEngine.setPreviewSizeType(CameraCapture.PreviewSizeType.PREVIEWSIZE16_9);
//land横屏为true， 竖屏为false
mEngine.startPreview(mCamraID, null, YaguLiveEngine_Ex.Render_Mode.fit_out.ordinal(), rotation == Surface.ROTATION_90 || rotation == Surface.ROTATION_270);

4.推荐推流配置

mconfig.setEncodeType(PushParam.PUSH_DATA_HARD_ENCODE);
mconfig.setVideoBitRate(1200*1000);//视频码率
mconfig.setAudioBitRate(48000);//声音码率
mconfig.setCrf(26);//画面压缩参数
mconfig.setNoVideo(false);

mconfig.setVideoFormat(ImageFormat.NV21);
mconfig.setVideoFrameRate(30);//帧率

mconfig.setVideoSize(YaguPushConfig.Push_Video_Size.SIZE_720);//分辨率
mconfig.setProfile(PushParam.PUSH_MAIN_PROFILE);
mconfig.setLogFlag(mconfig.PUSH_LOGFLAG_DEBUG);

5.开始推流

mEngine.setIsAdaptiveBitrate(true, YaguLiveEngine_Ex.AdaptiveBitrate_level.AdaptiveBitrate_1.ordinal());
mEngine.configEngine(mconfig);
mEngine.createEngine();
mEngine.setOnMessageListener(this, this, this,this);

mEngine.startPush(pushUrl, true);
mEngine.setAudioDataCallbackInterface(this);

6.退出销毁

if (isStartPreview) {
    try {
        mEngine.stopPreview();
        isStartPreview = false;
    } catch (Exception e) {
        Log.d(TAG, "stopPreview error");
    }

}
if (startPush) {

    try {
        mEngine.stopPush();
        mEngine.uinit();
        mEngine.destroyEngine();
        startPush = false;
    } catch (Exception e) {
        Log.d(TAG, "stopPreview error");
    }
}

进入后台

• 当推流端页面进入后台后，需调用enterBackGround做响应。进入后台后，不会引起断流，继续推音频流。在回到前台时，需在onResume中重新调用startPreview

@Override
protected void onResume() {
    Log.d(TAG, "MainActivity: onResume");
    super.onResume();

    if (mEngine != null) {
        int rotation = ((WindowManager)this.getSystemService(Context.WINDOW_SERVICE)).getDefaultDisplay().getRotation();
        mEngine.startPreview(mCamraID, null, YaguLiveEngine_Ex.Render_Mode.fit_out.ordinal(), rotation== Surface.ROTATION_90||rotation== Surface.ROTATION_270);
    }
}

@Override
public void surfaceCreated(SurfaceHolder arg0) {
    Log.e(TAG, "MainActivity: --------surfaceCreated-----");
    if (startPush && mEngine != null) {
        mEngine.enterBackGround(false);
    }
}

@Override
public void surfaceDestroyed(SurfaceHolder arg0) {
    Log.e(TAG, "MainActivity: --------surfaceDestroyed-----");
    mEngine.stopPreview();
    if (startPush && mEngine != null) {
        mEngine.enterBackGround(true);
    }
}

附加功能

1.静音

//开启
mEngine.mutedLocalStream(0, 2, true);
//关闭
mEngine.mutedLocalStream(0, 2, false);

2.开关闪光灯

//开启
mEngine.getCamCapture().turnLightOn();
//关闭
mEngine.getCamCapture().turnLightOff();

3.美颜

//开启
mEngine.setEffectType(EffectParam.PREVIEW_EFFECT_BEAUTY, beautyParam);
//关闭
mEngine.setEffectType(EffectParam.PREVIEW_EFFECT_NORMAL, null);

拉流步骤

1. 在AndroidManifesat文件下播放端Activity配置如下:

<activity android:name=".PlayActivity">
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE"/>
        <data android:mimeType="video/*" />
        <data android:mimeType="audio/*" />
        <data android:scheme="http" />
        <data android:scheme="file" />
    </intent-filter>
    <intent-filter>
        <action android:name="android.intent.action.SEND" />
        <category android:name="android.intent.category.DEFAULT" />
        <data android:mimeType="video/*" />
    </intent-filter>
</activity>

1. 在xml中使用videoView ```xml </com.mudu.yaguplayer.video.widget.media.IjkVideoView>

3. 获取VideoView，设置播放地址并播放
```java
mVideoView = findViewById(R.id.video_view);
mVideoView.setVideoPath(mVideoPath);
mVideoView.start();

重新播放

mVideoView.setVideoPath(inputVideoPath);
mVideoView.resume();
mVideoView.start();

结束播放

mVideoView.stopPlayback();
mVideoView.release(true);
mVideoView.stopBackgroundPlay();

错误码说明

1.推流错误码

2.播放错误码

• INFO

• ERROR

添加混淆文件

在proguard-rules.pro文件下添加如下代码：

-keep class com.mudu.**{*;}
-dontwarn com.mudu.**

-keep class com.yagu.**{*;}
-dontwarn com.yagu.**

-keep class com.audioengine.**{*;}
-dontwarn com.audioengine.**

-keep class tv.danmaku.**{*;}
-dontwarn tv.danmaku.**

Android SDK 下载 Android Demo 下载