欢拓直播点播SDK Android版说明文档


1. 导入SDK所需jar包和so包

Eclipse

将TalkFunSDK/libs目录下的TalkFunSD.jar和armeabi-v7a目录拷贝到项目工程的libs目录完成SDK的引用。如果工程目录没有libs文件夹,请在工程目录下建一个文件夹libs。 libs目录下的libs/armeabi-v7a目录的.so文件是用于支持播放直播视频文件,也需要添加在工程中。

Android Studio

引用jar文件

  1. 将TalkFunSDK/libs目录下的TalkFunSD.jar文件复制、粘贴到项目工程的Application Module的libs目录中;
  2. 右键点击jar文件,并点击弹出菜单中的“Add As Library”并将jar文件作为类库添加到项目中

引用so文件

  1. 在项目工程的Application Module的src/main目录中新建名为“jniLibs”的目录;
  2. 将TalkFunSDK/libs/armeabi-v7a目录拷贝到“jniLibs”目录内

2. 添加资源文件

将SDK提供的res目录除res\value目录外拷入工程目录下, 和工程本身res目录合并。请不要随便删除其中的文件。另将res\values目录下的文件内容与工程res\values下相应的文件内容合并

3. 配置AndroidManifest.xml

打开AndroidManifest.xml,添加SDK需要的权限到标签下:

<!--允许访问网络权限-->
<uses-permission android:name="android.permission.INTERNET" /> 
<!-- 允许检查网络状态权限-->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>

在相应的Activity标签添加声明configChanges属性,添加configChanges属性配置"keyboardHidden|orientation|screenSize"匹配横屏事件,使在屏幕方向改变时系统不重启Activity。

    android:configChanges="keyboardHidden|orientation|screenSize"

设置Activity横屏或竖屏显示

    android:screenOrientation="landscape"|"portrait"

4. 如何使用SDK

com.talkfun.sdk.MtFragment继承Fragment,该对象封装了播放直播或点播视频及用户交互操作,在项目中只要调用MtFragment展示播放页面就可观看直播或点播内容。

下面例子新建一个FragmentActivity的子类并将MtFragment添加到该类进行展示:

public class MainBoardActivity extends FragmentActivity{
    private MtFragment mMtFragment;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        String token = getIntent().getStringExtra("token");
        boolean isPlayback = getIntent().getBooleanExtra("isPlayback", false);
        mMtFragment = MtFragment.build(token,isPlayback);   
        getSupportFragmentManager().beginTransaction().add(android.R.id.content, mMtFragment).commit();
    }
}

5. 接口说明

com.talkfun.sdk.MtFragment类的接口如下:

public static MtFragment build(String token, boolean isPlayback)
创建一个MtFragment
参数:
    - String token:直播或点播的令牌
    - Boolean isPlayback:用来区别是直播还是点播(false:直播 true:点播)