初体验-阿里云短视频 SDK For Android 快速接入

简介: 近期的一些创意短视频 App 风靡年轻群体,比较典型的例如抖音、MUSE 等,阿里云也适时地推出了简单易用的短视频 SDK,帮助开发者们以较低的成本快速引入功能完备的创意短视频功能。本文主要介绍如何快速接入阿里云短视频 SDK 的三个版本(基础版、标准版和专业版)。

前言

近期的一些创意短视频 App 风靡年轻群体,比较典型的例如抖音、MUSE 等,阿里云也适时地推出了简单易用的短视频 SDK,帮助开发者们以较低的成本快速引入功能完备的创意短视频功能。
本文主要介绍如何快速接入阿里云短视频 SDK 的三个版本(基础版、标准版和专业版)。帮助开发者以最快的速度了解接入的基本方式。

本文描述的阿里云短视频 SDK 版本基于 3.4.0,后续升级接口变动请参考 阿里云短视频 SDK 文档
示例工程代码为 Kotlin,Java 接入类似。

正文

由于三个版本接入方式大同小异,本文将着重介绍基础版接入过程,标准版和专业版可以基于基础版方式接入,后续仅说明接入差异的地方。

基础版接入

1. 引入 aar 以及 so

目前 aar 平台版本最低要求 >= 4.3,先从SDK 下载页面下载相应版本的 SDK,解压之后,将 libs 文件夹下的 QuSdk-RC.aar 拷到 Android 工程模块中的 libs 文件夹下,将 jniLibs 文件夹下的 armeabi-v7a 文件夹也整体拷贝到 libs 文件夹下。
拷贝完成之后目录的文件如下:
image

之后按照如下方式修改 Android 项目工程主模块下的 build.gradle 文件:

Step1. 修改 jniLibs 的源文件夹;

android {
       sourceSets.main {
        jniLibs.srcDir "libs"
    }
}

Step2. 将 libs 文件夹加入仓库中;

repositories {
    flatDir {
        dirs 'libs'
    }
}

Step3. 增加 aar 所需依赖。

dependencies {
    implementation(name: 'QuSdk-RC', ext: 'aar')
    implementation 'com.android.support:appcompat-v7:24.2.1'
    implementation 'com.android.support:design:24.2.1'
    implementation 'com.google.code.findbugs:jsr305:3.0.0'
    implementation 'com.github.bumptech.glide:glide:3.7.0'
    implementation 'pub.devrel:easypermissions:0.2.1'
    implementation 'com.squareup.okhttp3:okhttp:3.2.0'
    implementation 'com.github.bumptech.glide:okhttp3-integration:1.4.0@aar'
    implementation 'com.squareup.okio:okio:1.12.0'
    implementation 'com.google.code.gson:gson:2.8.0'
 }

如果此处遭遇 java.lang.NoSuchFieldError 错误,可以参考短视频安卓常见问题解决。

2. 初始化 SDK

请根据具体的项目情况选择合适的 SDK 初始化时机,Demo 工程在 Applicatioin 的 onCreate() 方法中初始化。

package me.bogerchan.alishortvideodemo

import android.app.Application
import com.aliyun.common.httpfinal.QupaiHttpFinal

/**
 * Created by hb.chen on 2018/1/6.
 */
class MyApplication : Application() {
    override fun onCreate() {
        super.onCreate()
        System.loadLibrary("QuCore-ThirdParty")
        System.loadLibrary("QuCore")
        QupaiHttpFinal.getInstance().initOkHttpFinal()
    }
}

3. 开始书写你的业务逻辑

经过上述过程,实际上已经接入完成,这时候你可以参考文档直接开始使用各种 API 了,附下示例代码。

package me.bogerchan.alishortvideodemo

import android.Manifest
import android.app.Activity
import android.content.Intent
import android.content.pm.PackageManager
import android.os.Bundle
import android.support.v4.app.ActivityCompat
import android.support.v7.app.AppCompatActivity
import android.widget.Toast
import com.aliyun.demo.recorder.AliyunVideoRecorder
import com.aliyun.struct.common.VideoQuality
import com.aliyun.struct.snap.AliyunSnapVideoParam
import me.bogerchan.alishortvideodemo.basic.R


class MainActivity : AppCompatActivity() {

    companion object {
        val REQUEST_CODE_RECORD_VIDEO = 1
        val REQUEST_CODE_FOR_PERMISSION = 2
    }

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        findViewById(R.id.btn_start_record).setOnClickListener {
            startRecordActivity()
        }
        ActivityCompat.requestPermissions(this,
                arrayOf(Manifest.permission.WRITE_EXTERNAL_STORAGE,
                        Manifest.permission.READ_EXTERNAL_STORAGE,
                        Manifest.permission.CAMERA,
                        Manifest.permission.RECORD_AUDIO),
                REQUEST_CODE_FOR_PERMISSION)
    }

    private fun startRecordActivity() {
        val recordParam = AliyunSnapVideoParam.Builder()
                .setResolutionMode(AliyunSnapVideoParam.RESOLUTION_720P)
                .setRatioMode(AliyunSnapVideoParam.RATIO_MODE_9_16)
                .setRecordMode(AliyunSnapVideoParam.RECORD_MODE_AUTO)
                .setNeedClip(true)
                .setMaxDuration(10000)
                .setMinDuration(2000)
                .setVideQuality(VideoQuality.HD)
                .setSortMode(AliyunSnapVideoParam.SORT_MODE_MERGE)
                .build()
        AliyunVideoRecorder.startRecordForResult(this, REQUEST_CODE_RECORD_VIDEO, recordParam)
    }

    override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
        super.onActivityResult(requestCode, resultCode, data)
        when (requestCode) {
            REQUEST_CODE_RECORD_VIDEO -> {
                if (resultCode == Activity.RESULT_OK && data != null) {
                    val type = data.getIntExtra(AliyunVideoRecorder.RESULT_TYPE, 0)
                    if (type == AliyunVideoRecorder.RESULT_TYPE_CROP) {
                        Toast.makeText(this, "类型为裁剪", Toast.LENGTH_SHORT).show()
                    } else if (type == AliyunVideoRecorder.RESULT_TYPE_RECORD) {
                        Toast.makeText(this, "文件路径为 " + data.getStringExtra(AliyunVideoRecorder.OUTPUT_PATH), Toast.LENGTH_SHORT).show()
                    }
                } else if (resultCode == Activity.RESULT_CANCELED) {
                    Toast.makeText(this, "用户取消录制", Toast.LENGTH_SHORT).show()
                }
            }
        }
    }

    override fun onRequestPermissionsResult(requestCode: Int, permissions: Array<out String>, grantResults: IntArray) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults)
        when (requestCode) {
            REQUEST_CODE_FOR_PERMISSION -> {
                grantResults.forEach {
                    if (it == PackageManager.PERMISSION_DENIED) {
                        Toast.makeText(this, "没有权限,不玩了", Toast.LENGTH_SHORT).show()
                        finish()
                        return@forEach
                    }
                }
            }

        }
    }
}

标准版接入

1. 引入 aar 以及 so

标准版相较于基础版,在引入 so 文件时候多了几个文件,同时 aar 文件名有所变动。最终拷贝结果如下:
image
build.gradle 文件修改与基础版接入一样,只是需要将接入 aar 文件名替换成标准版对应的名字。

2. 初始化 SDK

相较于基础版,需要加载的 so 增多了几个,其中部分 so 文件作为可选功能根据实际情况决定是否加载,具体可以参阅阿里云短视频 SDK 文档。接入后的 Application 文件参考:

package me.bogerchan.alishortvideodemo

import android.app.Application
import com.aliyun.common.httpfinal.QupaiHttpFinal

/**
 * Created by hb.chen on 2018/1/6.
 */
class MyApplication : Application() {
    override fun onCreate() {
        super.onCreate()
        System.loadLibrary("aliresample")
        System.loadLibrary("live-openh264")
        System.loadLibrary("QuCore-ThirdParty")
        System.loadLibrary("QuCore")
        QupaiHttpFinal.getInstance().initOkHttpFinal()
    }
}

3. 开始书写你的业务逻辑

经过上述过程,实际上已经接入完成,这时候你可以参考文档直接开始使用各种 API 了,附下示例代码。

package me.bogerchan.alishortvideodemo

import android.Manifest
import android.content.pm.PackageManager
import android.opengl.GLSurfaceView
import android.os.Bundle
import android.support.v4.app.ActivityCompat
import android.support.v7.app.AppCompatActivity
import android.widget.Toast
import com.aliyun.recorder.AliyunRecorderCreator
import com.aliyun.struct.recorder.CameraType
import com.aliyun.struct.recorder.MediaInfo
import me.bogerchan.alishortvideodemo.std.R


class MainActivity : AppCompatActivity() {

    companion object {
        val REQUEST_CODE_FOR_PERMISSION = 1
    }

    private val mRecorder by lazy {
        AliyunRecorderCreator.getRecorderInstance(this)
    }

    private var mCameraType = CameraType.FRONT

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        ActivityCompat.requestPermissions(this,
                arrayOf(Manifest.permission.WRITE_EXTERNAL_STORAGE,
                        Manifest.permission.READ_EXTERNAL_STORAGE,
                        Manifest.permission.CAMERA,
                        Manifest.permission.RECORD_AUDIO),
                REQUEST_CODE_FOR_PERMISSION)
        initAliyunRecorder()
        findViewById(R.id.btn_start_record).setOnClickListener {
            Toast.makeText(this, "开始录制片段", Toast.LENGTH_SHORT).show()
            mRecorder.startRecording()
        }
        findViewById(R.id.btn_stop_record).setOnClickListener {
            Toast.makeText(this, "停止录制片段", Toast.LENGTH_SHORT).show()
            mRecorder.stopRecording()
        }
        findViewById(R.id.btn_finish_record).setOnClickListener {
            Toast.makeText(this, "结束录制", Toast.LENGTH_SHORT).show()
            mRecorder.finishRecording()
        }

        findViewById(R.id.btn_change_camera_type).setOnClickListener {
            Toast.makeText(this, "切换前后置", Toast.LENGTH_SHORT).show()
            mRecorder.switchCamera()
        }
    }

    override fun onStart() {
        super.onStart()
        mRecorder.startPreview()
    }

    override fun onPause() {
        super.onPause()
        mRecorder.stopPreview()
    }

    override fun onDestroy() {
        super.onDestroy()
        AliyunRecorderCreator.destroyRecorderInstance()
    }

    private fun initAliyunRecorder() {
        mRecorder.setDisplayView(findViewById(R.id.glsv_content) as GLSurfaceView)
        val mediaInfo = MediaInfo()
        mediaInfo.videoWidth = 800
        mediaInfo.videoHeight = 1200
        mediaInfo.isHWAutoSize = true
        mRecorder.setMediaInfo(mediaInfo)
        mRecorder.setCamera(mCameraType)
        mRecorder.setOutputPath(externalCacheDir.absolutePath + "/capture.mp4")
    }

    override fun onRequestPermissionsResult(requestCode: Int, permissions: Array<out String>, grantResults: IntArray) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults)
        when (requestCode) {
            REQUEST_CODE_FOR_PERMISSION -> {
                grantResults.forEach {
                    if (it == PackageManager.PERMISSION_DENIED) {
                        Toast.makeText(this, "没有权限,不玩了", Toast.LENGTH_SHORT).show()
                        finish()
                        return@forEach
                    }
                }
            }

        }
    }
}

专业版接入

1. 引入 aar 以及 so

专业版相较于基础版,在引入 so 文件时候多了几个文件,同时 aar 文件名有所变动。最终拷贝结果如下:
image

build.gradle 文件修改与基础版接入一样,只是需要将接入 aar 文件名替换成专业版对应的名字。

2. 初始化 SDK

相较于基础版,需要加载的 so 增多了几个,其中部分 so 文件作为可选功能根据实际情况决定是否加载,具体可以参阅阿里云短视频 SDK 文档。接入后的 Application 文件参考:

package me.bogerchan.alishortvideodemo

import android.app.Application
import com.aliyun.common.httpfinal.QupaiHttpFinal

/**
 * Created by hb.chen on 2018/1/6.
 */
class MyApplication : Application() {
    override fun onCreate() {
        super.onCreate()
        System.loadLibrary("live-openh264")
        System.loadLibrary("QuCore-ThirdParty")
        System.loadLibrary("QuCore")
        System.loadLibrary("FaceAREngine")
        System.loadLibrary("AliFaceAREngine")
        QupaiHttpFinal.getInstance().initOkHttpFinal()
    }
}

3. 开始书写你的业务逻辑

经过上述过程,实际上已经接入完成,这时候你可以参考文档直接开始使用各种 API 了,附下示例代码。

package me.bogerchan.alishortvideodemo

import android.Manifest
import android.content.pm.PackageManager
import android.opengl.GLSurfaceView
import android.os.Bundle
import android.support.v4.app.ActivityCompat
import android.support.v7.app.AppCompatActivity
import android.widget.Toast
import com.aliyun.recorder.AliyunRecorderCreator
import com.aliyun.struct.recorder.CameraType
import com.aliyun.struct.recorder.MediaInfo
import me.bogerchan.alishortvideodemo.pro.R


class MainActivity : AppCompatActivity() {

    companion object {
        val REQUEST_CODE_FOR_PERMISSION = 1
    }

    private val mRecorder by lazy {
        AliyunRecorderCreator.getRecorderInstance(this)
    }

    private var mCameraType = CameraType.FRONT

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        ActivityCompat.requestPermissions(this,
                arrayOf(Manifest.permission.WRITE_EXTERNAL_STORAGE,
                        Manifest.permission.READ_EXTERNAL_STORAGE,
                        Manifest.permission.CAMERA,
                        Manifest.permission.RECORD_AUDIO),
                REQUEST_CODE_FOR_PERMISSION)
        initAliyunRecorder()
        findViewById(R.id.btn_start_record).setOnClickListener {
            Toast.makeText(this, "开始录制片段", Toast.LENGTH_SHORT).show()
            mRecorder.startRecording()
        }
        findViewById(R.id.btn_stop_record).setOnClickListener {
            Toast.makeText(this, "停止录制片段", Toast.LENGTH_SHORT).show()
            mRecorder.stopRecording()
        }
        findViewById(R.id.btn_finish_record).setOnClickListener {
            Toast.makeText(this, "结束录制", Toast.LENGTH_SHORT).show()
            mRecorder.finishRecording()
        }

        findViewById(R.id.btn_change_camera_type).setOnClickListener {
            Toast.makeText(this, "切换前后置", Toast.LENGTH_SHORT).show()
            mRecorder.switchCamera()
        }
    }

    override fun onStart() {
        super.onStart()
        mRecorder.startPreview()
    }

    override fun onPause() {
        super.onPause()
        mRecorder.stopPreview()
    }

    override fun onDestroy() {
        super.onDestroy()
        AliyunRecorderCreator.destroyRecorderInstance()
    }

    private fun initAliyunRecorder() {
        mRecorder.setDisplayView(findViewById(R.id.glsv_content) as GLSurfaceView)
        val mediaInfo = MediaInfo()
        mediaInfo.videoWidth = 800
        mediaInfo.videoHeight = 1200
        mediaInfo.isHWAutoSize = true
        mRecorder.setMediaInfo(mediaInfo)
        mRecorder.setCamera(mCameraType)
        mRecorder.needFaceTrackInternal(true)
        mRecorder.setOutputPath(externalCacheDir.absolutePath + "/capture.mp4")
    }

    override fun onRequestPermissionsResult(requestCode: Int, permissions: Array<out String>, grantResults: IntArray) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults)
        when (requestCode) {
            REQUEST_CODE_FOR_PERMISSION -> {
                grantResults.forEach {
                    if (it == PackageManager.PERMISSION_DENIED) {
                        Toast.makeText(this, "没有权限,不玩了", Toast.LENGTH_SHORT).show()
                        finish()
                        return@forEach
                    }
                }
            }

        }
    }
}

结语

至此已经介绍完了阿里云短视频 SDK 的接入方法,示例代码展示的仅仅只是阿里云视频 SDK 强大功能的冰山一角,开发者们可以通过相关的 SDK 文档获取更多的接口信息。如果集成过程中遇到问题,在联系客服之前不妨先看下 常见问题解决,说不定你的问题就在里面。

目录
相关文章
|
2月前
|
JavaScript 前端开发 Java
[Android][Framework]系统jar包,sdk的制作及引用
[Android][Framework]系统jar包,sdk的制作及引用
43 0
|
2月前
|
开发工具 Android开发
解决Android运行出现NDK at /Library/Android/sdk/ndk-bundle did not have a source.properties file
解决Android运行出现NDK at /Library/Android/sdk/ndk-bundle did not have a source.properties file
139 4
解决Android运行出现NDK at /Library/Android/sdk/ndk-bundle did not have a source.properties file
|
2月前
|
Java 开发工具
通过Java SDK调用阿里云模型服务
在阿里云平台上,可以通过创建应用并使用模型服务完成特定任务,如生成文章内容。本示例展示了一段简化的Java代码,演示了如何调用阿里云模型服务生成关于“春秋战国经济与文化”的简短文章。示例代码通过设置系统角色为历史学家,并提出文章生成需求,最终处理并输出生成的文章内容。在实际部署前,请确保正确配置环境变量中的密钥和ID,并根据需要调整SDK导入语句及类名。更多详情和示例,请参考相关链接。
|
2月前
|
开发工具 图形学 Android开发
Unity与安卓丨unity报错:SDK Tools version 0.0 < 26.1.1
Unity与安卓丨unity报错:SDK Tools version 0.0 < 26.1.1
|
2月前
|
开发工具 Android开发
Android项目架构设计问题之SDK内部减少每次回调时的冗余判断逻辑如何解决
Android项目架构设计问题之SDK内部减少每次回调时的冗余判断逻辑如何解决
21 0
|
2月前
|
Java API 开发工具
Android项目架构设计问题之为SDK添加新的回调支持如何解决
Android项目架构设计问题之为SDK添加新的回调支持如何解决
18 0
|
6天前
|
IDE Android开发 iOS开发
探索Android与iOS开发的差异:平台选择对项目成功的影响
【9月更文挑战第27天】在移动应用开发的世界中,Android和iOS是两个主要的操作系统平台。每个系统都有其独特的开发环境、工具和用户群体。本文将深入探讨这两个平台的关键差异点,并分析这些差异如何影响应用的性能、用户体验和最终的市场表现。通过对比分析,我们将揭示选择正确的开发平台对于确保项目成功的重要作用。
|
19天前
|
Android开发 开发者 Kotlin
探索安卓开发中的新特性
【9月更文挑战第14天】本文将引导你深入理解安卓开发领域的一些最新特性,并为你提供实用的代码示例。无论你是初学者还是经验丰富的开发者,这篇文章都会给你带来新的启示和灵感。让我们一起探索吧!
|
3天前
|
开发框架 移动开发 Android开发
安卓与iOS开发中的跨平台解决方案:Flutter入门
【9月更文挑战第30天】在移动应用开发的广阔舞台上,安卓和iOS两大操作系统各自占据半壁江山。开发者们常常面临着选择:是专注于单一平台深耕细作,还是寻找一种能够横跨两大系统的开发方案?Flutter,作为一种新兴的跨平台UI工具包,正以其现代、响应式的特点赢得开发者的青睐。本文将带你一探究竟,从Flutter的基础概念到实战应用,深入浅出地介绍这一技术的魅力所在。
18 7
|
6天前
|
开发框架 前端开发 Android开发
安卓与iOS开发中的跨平台解决方案
【9月更文挑战第27天】在移动应用开发的广阔天地中,安卓和iOS两大操作系统如同双子星座般耀眼。开发者们在这两大平台上追逐着创新的梦想,却也面临着选择的难题。如何在保持高效的同时,实现跨平台的开发?本文将带你探索跨平台开发的魅力所在,揭示其背后的技术原理,并通过实际案例展示其应用场景。无论你是安卓的忠实拥趸,还是iOS的狂热粉丝,这篇文章都将为你打开一扇通往跨平台开发新世界的大门。
下一篇
无影云桌面