素材库使用

素材分类

素材根据功能类型和场景的不同，分为主题、滤镜、贴纸、字幕、转场、粒子、脸贴。

• 主题

主题是短视频SDK中一键式视频包装的手段，能够快速将一个普通视频，包装出电影级的视频效果，是快速美化视频的首选。

• 滤镜

滤镜是对视频画面进行艺术处理的主要手段，不仅包含常见的调色型滤镜，同时还有画面前景处理滤镜（例如飘雪），画面进行复杂处理的特效型滤镜（抖音式）、以及对画面进行遮罩的边框型滤镜等等。

• 贴纸

贴纸是对于视频画面进行点缀性修饰的主要手段，可以在画面上增加各种元素，进行整体视频气氛的烘托。除了简单贴纸，素材库还提供非常复杂的运动效果的贴纸样式，及有声贴纸等。

• 字幕样式

字幕样式是用于文字本身进行特效处理的一种方式，每个字幕样式定义了文字的包装、运动的效果，让文字同样可以实现非常绚丽的展现。

• 转场

转场是对两个视频间过渡所进行特效处理的手段，在无转场的情况下，视频通常会是比较生硬的切换，但是加入转场后，则会形成非常平滑，优美的视频串联效果，增强视频的连贯性和感染力。

• 粒子

粒子特效是一种趣味的短视频交互玩法。通过人脸识别、手势识别可触发粒子特效的喷射。例如在创作拍摄过程中，通过摄像头获取面部眼睛位置，使得用户在视频拍摄过程中只需眨眼睛就可以实现“闪耀精灵眼”；定位嘴部并张开，粒子就会从嘴巴里飞跃出来，实现火焰喷发、音符跳动等特效。

• 脸贴

脸贴可实现“换脸”功能。基于人脸识别技术，通过摄像头获取面部位置，加载脸贴进行换脸。

试用素材

试用版本（没有License）的短视频SDK可直接试用素材库中的素材，试用版本SDK会带有水印。若要去除水印，请参见License申请购买SDK License。在试用过程中的开发代码同样可以在正式授权后应用，而无需更改，最大程度节省了开发周期。

1. 进入华为开发者中心，下载短视频SDK。
2. 登录视频点播控制台，单击左侧导航“短视频 > 素材库”。
3. 在素材库页面选择合适的素材，单击“下载”按钮下载对应素材。
4. 下载后，即可在SDK中进行开发试用。

   Android用户可参见Android SDK-素材包。

   iOS用户可参见iOS SDK -素材包。

获取素材授权

当您和华为云服务正式确认了合作协议后，华为云服务会根据合作协议提供相关的素材授权文件。

在带有正式授权的SDK中，需要使用附加授权文件的素材。否则仅使用素材文件本身，而无授权，会导致使用素材失败。

1. 登录视频点播控制台，单击左侧导航“短视频 > 素材库”。
2. 在素材库页面选择合适的素材，记录名称和UUID，并以邮件的形式提交给您对接的商务人员。

   商务人员会给您进行相关授权，并在完成后通知您。

3. 收到通知后，登录视频点播控制台，单击左侧导航“短视频 > 已购素材”，进入已购素材页面。
4. 在已购素材页面分别单击“素材”和“授权”，获取素材文件和授权文件。

使用授权素材

获得素材文件和对应的授权后，您可以将它们在带有正式授权的SDK中进行使用。您需要在安装使用某个素材时，传入对应的授权文件即可。

1. 传入授权文件，获取授权文件地址。
2. 初始化StreamingContext。
3. 通过资源包管理器安装素材。
   • Android安装示例：

   1 2 3 4 5

   /安装字幕样式。 //captionStyleFilePath:字幕样式包路径 //LicenseFilePath:对应授权文件地址 //captionStylePackageId：字幕样式包ID m_streamingContext.getAssetPackageManager().installAssetPackage(captionStyleFilePath,licenseFilePath, NvsAssetPackageManager.ASSET_PACKAGE_TYPE_ANIMATEDSTICKER, true, captionStylePackageId);

   • iOS安装示例：

   1 2 3 4 5

   //安装字幕样式。 //captionStyleFilePath:字幕样式包路径 //LicenseFilePath:对应授权文件地址 //captionStylePackageId：字幕样式包ID [m_streamingContext.assetPackageManager installAssetPackage:captionStyleFilePath lisence:licenseFilePath type:NvsAssetPackageType_CationStyle sync: YES assetPackageId:captionStylePackageId];