教你1天搭建自己的“微视”

欢迎大家前往腾讯云+社区,获取更多腾讯海量技术实践干货哦~

本文由腾讯视频云终端团队 发表于云+社区专栏

第一步 登录腾讯云官网,开通短视频控制台,申请license

img

第二步 工程配置iOS或者Android

工程配置iOS

Xcode Project Settings

I. Supported Platform

  • SDK supports iOS 8.0 or above.

II. Development Environment

  • Xcode 8 or above
  • OS X 10.10 or above

III. Xcode Project Settings

A simple iOS Application project is shown below to illustrate how to configure SDK in an Xcode project.

1. Copy SDK File

In this example, an iOS project named HelloSDK is created, and the downloaded TXLiteAVSDK_UGC.framework is copied to the project directory. The figure below shows the directory structure.

2. Add Framework

Add TXLiteAVSDK_UGC.framework to the project. At the same time, add the following dependent libraries:

libz.tbd

Accelerate.framework

Bugly.framework

After you've added the above libraries, the project dependency shows as follows:

3. Add Header File

Add the search path for header file to "Build Settings" -> "Search Paths" -> "User Header Search Paths". Please note that this operation is not required. If you do not add the header file search path for TXLiteAVSDK_UGC, "TXLiteAVSDK_UGC/" needs to be added before the SDK-related header file when the header file is referenced, as shown below:

#import "TXLiteAVSDK_UGC/TXUGCRecord.h"

IV. Verification

Next, call the SDK API in the codes of HelloSDK to obtain SDK version information and verify whether the project is correctly configured.

1. Reference the Header File

Reference the SDK header file at the beginning of ViewController.m:

#import "TXLiteAVSDK_UGC/TXLiveBase.h"

2. Add Calling Code

Add the following code to the viewDidLoad method:

- (void)viewDidLoad {
    [super viewDidLoad];
    // Print SDK version information
    NSLog(@"SDK Version = %@", [TXLiveBase getSDKVersionStr]);
}

3. Compile and Run

If all of the above steps are performed correctly, the HelloSDK project can be compiled successfully. Run the App in the Debug mode. SDK version information is output in Xcode's Console pane.

2017-09-26 16:16:15.767 HelloSDK17929:7488566 SDK Version = 3.4.1761

Now, the project configuration is completed.

Printing LOG

Configure whether to print log in the console and set the log level in TXLiveBase. Codes are described as follows:

  • setConsoleEnabled Configure whether to print the output of SDK in the Xcode console.
  • setLogLevel Configure whether to allow SDK to print local log. By default, SDK writes log to the Documents/logs folder of the current App. For technical support, you are recommended to enable the sub-switch and provide the log file after a problem occurs. Thank you for your support.
  • View log file To reduce the storage volume of logs, Mini LVB SDK encrypts the log files stored locally and limits the number of logs. Therefore, you need to use the log Decompression Tool to view the text content of log.
[TXLiveBase setConsoleEnabled:YES];
[TXLiveBase setLogLevel:LOGLEVEL_DEBUG];

工程配置Android

1. System Requirement

SDK can run on Android 4.0.3 (API 15) or above. However, hardware encoding can be enabled only on Android 4.3 (API 18) or above.

2. Development Environment

SDK development environment is described below. The App development environment does not need to be consistent with that of SDK, but it must be compatible with:

  • Android NDK: android-ndk-r12b

  • Android SDK Tools: android-sdk_25.0.2

    • minSdkVersion: 15

    • targetSdkVersion: 21

  • Android Studio (Android Studio is recommended, but you can also use Eclipse + ADT)

3. Integration Guide (aar)

3.1 New Project

3.2 Copy Files

Put the aar package under the project libs directory

3.3 Project Configuration

  • Add the code that references aar package to build.gradle under the project app directory:dependencies {

    ​ compile fileTree(dir: 'libs', include: ['*.jar'])

    ​ // Import the short video SDK aar

    ​ compile(name: 'LiteAVSDK_UGC_3.4.1757', ext: 'aar')

    }

  • Add flatDir to build.gradle under the project directory, and specify the local library in it:allprojects {

    ​ repositories {

    ​ jcenter()

    ​ flatDir {

    ​ dirs 'libs'

    ​ }

    ​ }

    }

  • Specify ndk-compatible architecture in defaultConfig of build.gradle under the project directory: defaultConfig {

    ​ applicationId "com.tencent.liteav.demo"

    ​ minSdkVersion rootProject.ext.minSdkVersion

    ​ targetSdkVersion rootProject.ext.targetSdkVersion

    ​ versionCode 1

    ​ versionName "2.0"

    ​ ndk {

    ​ abiFilters "armeabi", "armeabi-v7a"

    ​ }

    ​ }

  • Finally, compile Rebuild Project.

4 Integration Guide (jar)

4.1 Library Description

Decompress LiteAVSDK_UGC_3.4.1757.zip to get the libs directory, which mainly includes a jar file, as shown below:

jar file Description
liteavsdk.jar Mini LVB SDK android core library

For library related to the upload of short videos, jar files and a so file for uploading short videos can be found in the Demo\app\libs directory, as shown below:

jar file Description
sha1utils.jar JAR package that implements SHA calculation of files to be uploaded. This component is used for short video upload (TXUGCPublish) feature
cos-sdk-android.1.4.3.11.jar File upload package of Tencent Cloud COS. This component is used for short video upload (TXUGCPublish) feature
okio-1.6.0.jar An excellent open source network I/O component
okhttp-3.2.0.jar An excellent open source HTTP component
so file Description
libTXSHA1.so JAR package that implements SHA calculation of files to be uploaded. This component is used for short video upload (TXUGCPublish) feature

4.2 Copy Files

If no jni loading path is previously specified in your project, we recommend that you put the jar package and so library under the /src/main/jniLibs directory, which is the default jni loading directory of android studio.

4.3. Project Configuration

Add the code that references jar package and so library to build.gradle under the project app directory:

dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar'])
    // Import Tencent Cloud LVB SDK jar
    compile fileTree(dir: 'src/main/jniLibs', includes: ['*.jar'])
}

5. Configure App Permissions

Configure App permissions in AndroidManifest.xml. Generally, video Apps require the following permissions:

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.CALL_PHONE"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.READ_LOGS" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.CAMERA" />
<uses-feature android:name="android.hardware.Camera"/>
<uses-feature android:name="android.hardware.camera.autofocus" />

6. Verify

Call the SDK API in the project to get SDK version information and verify whether the project is correctly configured.

6.1 Reference SDK

Reference the class of SDK in MainActivity.java:

import com.tencent.rtmp.TXLiveBase;

6.2 Call API

Call the API getSDKVersioin in onCreate to get version number:

String sdkver = TXLiveBase.getSDKVersionStr();
Log.d("liteavsdk", "liteav sdk version is : " + sdkver);

6.3 Compile and Run

The demo project can be compiled successfully if all of the above steps are correctly performed. If you run the project, you can see the following log information in logcat:

09-26 19:30:36.547 19577-19577/ D/liteavsdk: liteav sdk version is : 3.4.1757

7. Print LOG

Configure whether to print log in the console and set the log level in TXLiveBase. Codes are described as follows:

  • setConsoleEnabled Configure whether to print the output of SDK in the Android Studio console.
  • setLogLevel Configure whether to allow SDK to print local log. By default, SDK writes log to the log / tencent / liteav folder on sdcard. For technical support, you are recommended to enable the switch and provide the log file after a problem occurs. Thank you for your support.
  • View log file To reduce the storage volume of logs, Mini LVB SDK encrypts the log files stored locally and limits the number of logs. Therefore, you need to use the log Decompression Tool to view the text content of log.
TXLiveBase.setConsoleEnabled(true);
TXLiveBase.setLogLevel(TXLiveConstants.LOG_LEVEL_DEBUG);

8. Troubleshooting

8.1 Compilation

If the following errors occur when you compile/run the project after importing the SDK into it:

Caused by: android.view.InflateException: 
Binary XML file #14:Error inflating class com.tencent.rtmp.ui.TXCloudVideoView

Find the problem by following the steps below:

  • Check whether you have placed the jar package and so library into the jniLibs directory.

  • If you are using the full version of aar integration mode, check whether the x64 "so" library has been filtered out in defaultConfig of build.gradle under the project directory. This is because the acoustic component library used by the joint broadcasting feature in full version does not support mobile phones with x64 architecture at the moment. defaultConfig {

    ​ applicationId "com.tencent.liteav.demo"

    ​ minSdkVersion rootProject.ext.minSdkVersion

    ​ targetSdkVersion rootProject.ext.targetSdkVersion

    ​ versionCode 1

    ​ versionName "2.0"

    ​ ndk {

    ​ abiFilters "armeabi", "armeabi-v7a"

    ​ }

    }

  • Check the proguard rules to confirm that the SDK-related package names have been added to the non-proguard list.-keep class com.tencent.**

8.2 Short Video Publishing

After a file is published, no error message or callback response is returned. The following appears when the log is printed:

 TaskManager: ExecutionException

This is because the libTXSHA1.so used for upload has not been properly integrated into the project. For more information, please see Integration Guide.

第三步 完成工程配置后,可进行【视频录制】功能的集成

如果你是iOS开发,可参考视频录制(iOS)

如果你是Android开发,可参考视频录制(Android)

第四步 完成【视频录制】功能的集成后,可继续集成【视频剪辑】功能

如果你是iOS开发,可参考视频编辑(iOS)

如果你是Android开发,可参考视频编辑(Android)

问答

腾讯云服务器?

相关阅读

教你从0到1搭建小程序音视频

教你快速搭建一场发布会直播方案

移形换影 - 短视频色彩特效背后的故事

此文已由作者授权腾讯云+社区发布,原文链接:https://cloud.tencent.com/developer/article/1153620?fromSource=waitui

欢迎大家前往腾讯云+社区或关注云加社区微信公众号(QcloudCommunity),第一时间获取更多海量技术实践干货哦~

海量技术实践经验,尽在云加社区! https://cloud.tencent.com/developer?fromSource=waitui

posted @ 2018-07-10 11:03  腾讯云开发者  阅读(1354)  评论(0编辑  收藏  举报