QFAV简介

QFAV-快速搭建一个Andriod的demo

 

本文重点为如何教你使用QFAV快速搭建一个android一对一的demo，感觉没有必要每一步都上图，所以某些操作需要大家自己脑补。

服务器部署：我们同时提供了mac，Windows与Linux的服务器，只需要简单的./EXE即可运行，其中fvideo视频服务端口为固定10005，faudio固定端口为10006 我们会持续优化

Mac:

Windows:

Liunx:

1.首先新建项目，我们选择一个empty的Active，取名QFAVAndroidDemo，工作目录为workvideo

2.将jinlibs拷贝的到src/main目录下与java,res同级。

3.新建App.java做为程序入口,在Andriodmainifest.xml中增加权限以及APP声明

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="workvideo.fvideo">

    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <uses-permission android:name="android.permission.BLUETOOTH" />
    <uses-permission android:name="android.permission.NETWORK" />
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.RECORD_AUDIO" />
    <uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
    <uses-permission android:name="android.permission.CAMERA" />
    <uses-feature android:name="android.hardware.camera" />

    <application
        android:name=".App"
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />

                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>

</manifest>

4.拷贝RealtimeSdk与当前包同级目录中,App.java中引入com.RealtimeSdk.*;并且对SDK初始化

package workvideo.fvideo;

import android.app.Application;
import android.util.Log;

import workvideo.RealtimeSdk.*;

public class App extends Application
{
    public static final String TAG ="meeting.debug";

    static App instance =null;


    @Override
    public void onCreate()
    {
        super.onCreate();

        instance =this;

        // 启动SDK
        RealTime.init();

        // 初始化声音
        Sound.instance.Init(this);

        // 设置空白视频画面
        RealTime.set_blank(getAssets(), "blank");
    }

    void onExit()
    {
        RealTime.uninit();

        Log.w(TAG, "onExit()");

        System.exit(0);
    }
}

5.我们的前面准备都已经完成，现在开始我们的大活儿

5.1我们先铺满整个应用，调起我们的摄像头，active_main.xml中配置摄像头，布局目前仅支持android.widget.RelativeLayout，对于带来不好的体验万分抱歉，我们会后续持续优化

<?xml version="1.0" encoding="utf-8"?>
<android.widget.RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">

    <workvideo.RealtimeSdk.CameraView
        android:id="@+id/cameraView"
        android:layout_width="match_parent"
        android:layout_height="match_parent" />

</android.widget.RelativeLayout>

MainActive.java中，继承RealtimeSDK.VideoActivity,方便后续调用桌面共享，高版本可能回提示onside的抽象，所以重载一下protected void onSize(int width, int height){}，在初始化的时候检查一下用户权限

package workvideo.qfavandroiddemo;

import androidx.appcompat.app.AppCompatActivity;

import android.os.Bundle;

import workvideo.RealtimeSdk.VideoActivity;

public class MainActivity extends VideoActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        checkPermission();

    }

    protected void onSize(int width, int height){}
}

5.2 我们现在集成播放器，同时布局好推流拉流按钮，所以我在relative里添加了一个线性布局，好让窗口自适应填充.在这里我重点解释一下，对了应对多人同时在线语音的场景，我们设计了Fvideo与Faudio两个服务器，fvideo可以同时推流音频与视频，faudio仅支持推流音频，房间内人数过多的时候，我们建议采用faudio走音频，faudio的推流方式是fauido://ip:10006/gourpid,拉流一样是fauido://ip:10006/gourpid，而fvideo推流方式是fvideo://ip:10005/userid,拉流同样，这里我们设置用户userid为1234，gourpid为1

所以我们安排了两个player，其中一个用于播放音频，应对多人情况

<?xml version="1.0" encoding="utf-8"?>
<androidx.appcompat.widget.LinearLayoutCompat xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    tools:context=".MainActivity">


    <workvideo.RealtimeSdk.CameraView
        android:id="@+id/cameraView"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_weight="1"/>
    <EditText
        android:id="@+id/editTextPush0"
        android:layout_width="match_parent"
        android:layout_height="40dp"
        android:ems="10"
        android:inputType="textUri"
        android:text="fvideo://124.239.190.120:10005/1234" />
    <EditText
        android:id="@+id/editTextPush1"
        android:layout_width="match_parent"
        android:layout_height="40dp"
        android:ems="10"
        android:inputType="textUri"
        android:text="faudio://124.239.190.120:10006/1" />
    <Button
        android:id="@+id/buttonPush"
        android:layout_width="match_parent"
        android:layout_height="40dp"
        android:text="推送" />

    <workvideo.RealtimeSdk.PlayerView
        android:id="@+id/playerView"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_weight="1" />
    <workvideo.RealtimeSdk.PlayerView
        android:id="@+id/playerViewAudio"
        android:layout_width="match_parent"
        android:layout_height="1dp" />
    <EditText
        android:id="@+id/editTextPull0"
        android:layout_width="match_parent"
        android:layout_height="40dp"
        android:ems="10"
        android:inputType="textUri"
        android:text="fvideo://124.239.190.120:10005/1234" />
    <EditText
        android:id="@+id/editTextPull1"
        android:layout_width="match_parent"
        android:layout_height="40dp"
        android:ems="10"
        android:inputType="textUri"
        android:text="faudio://124.239.190.120:10006/1" />
    <Button
        android:id="@+id/buttonPull"
        android:layout_width="match_parent"
        android:layout_height="40dp"
        android:layout_alignTop="@+id/editText"
        android:text="拉取" />

</androidx.appcompat.widget.LinearLayoutCompat>

5.3 开始集成java，代码，首先我们需要初始化，并且监听一下声音

 Sound.instance.start(); //开启声音设备
 findViewById(R.id.buttonPush).setOnClickListener(this);
 findViewById(R.id.buttonPull).setOnClickListener(this);

监听推流按钮事件，开启两路推流 0 推流视频，1推流音频，同时设置userID

    if( !Sound.mic_state() ) {
                    // 开始推送
      EditText editpush0 =findViewById(R.id.editTextPush0);
      RealTime.set_push_url(0,editpush0.getText().toString());

      EditText editpush1 =findViewById(R.id.editTextPush1);
      RealTime.set_push_url(1,editpush1.getText().toString());

      RealTime.set_push_uid(12345); // any 64bit number

      RealTime.set_video_source(RealTime.source_camera);
      Sound.set_mic_state(true);

      ((Button)view).setText("停止推送");
  }
  else {
      // 停止推送
      Sound.set_mic_state(false);
      RealTime.set_video_source(RealTime.source_none);
      RealTime.set_push_url(0,null);
      RealTime.set_push_url(1,null);
      ((Button)view).setText("开始推送");
  }

监听拉流事件，一个播放器播放视频，一个播放器播放音频，注：一个房间只需要一个音频播放器即可，我们内部会处理大房间内所有的声音，所以，你不用担心一个房间里100甚至1000个人说话会受到影响。

PlayerView playerView =(PlayerView)findViewById(R.id.playerView);
                PlayerView playerViewAudio =(PlayerView)findViewById(R.id.playerViewAudio);
                if (isPlaying) {
                    // 停止播放
                    playerView.stop();
                    playerView.load(null);

                    playerViewAudio.stop();
                    playerViewAudio.load(null);

                    isPlaying =false;
                    ((Button)view).setText("开始播放");
                }
                else {
                    // 开始播放
                    EditText editpull0 =findViewById(R.id.editTextPull0);
                    playerView.load(editpull0.getText().toString());
                    //playerView.play(RealTime.PLAY_BIT_AUDIO | RealTime.PLAY_BIT_VIDEO);
                    playerView.play(RealTime.PLAY_BIT_VIDEO);

                    EditText editpull1 =findViewById(R.id.editTextPull1);
                    playerViewAudio.load(editpull1.getText().toString());
                    playerViewAudio.play(RealTime.PLAY_BIT_AUDIO);

                    isPlaying =true;
                    ((Button)view).setText("停止播放");
                }

这样我们就完成了一个QFAV安卓的快速一对一集成，github源码地址为：

https://github.com/twomsoft/qfav/tree/master/android/QFAVAndroidDemo

有什么想法跟意见，欢迎随时评论