YY-EVA iOS

June 9, 2026 · View on GitHub

简体中文 | English

轻量级高性能跨平台 MP4 礼物播放器

支持本项目

请支持我们的项目，点击⭐⭐⭐, 让更多的人看到该项目

案例演示

介绍

YYEVAPlayer 是一个轻量的动画渲染库。通过这里导出动画文件
通过这里可以获取设计的测试资源文件
YYEVA-iOS 使用原生 Metal 库渲染视频，为你提供高性能、低开销的动画体验。

平台支持

支持 Android、IOS、Web 点击了解详细接入
资源制作的AE插件使用规范详情
数据结构定义详情
项目相关文章、设计规范等详情

用法

使用Cocoapods安装依赖

使用 CocoaPods 安装依赖
添加依赖 'YYEVA' 到 Podfile 文件中:

target 'MyApp' do 
  pod 'YYEVA'
end

使用SPM安装依赖

dependencies: [
    .package(url: "https://github.com/yylive/YYEVA-iOS.git", .upToNextMajor(from: "1.1.19"))
]

放置混合 mp4 文件在bundle中

代码

创建一个YYEVAPlayer实例

YYEVAPlayer *player = [[YYEVAPlayer alloc] init];
[self.view addSubview:player]; 

//config dynmaic elements 
[player setImageUrl:localPath forKey:@"image_key1"];   
[player setImageUrl:localPath forKey:@"image_key2"];
[player setImageUrl:localPath forKey:@"image_key3"];
[player setText:str.text forKey:@"text_key1"];
 
[player play:file];

其中以下接口是给MP4动态插入,业务文字或图片的接口

setImageUrl:forKey
setText:forKey

YYEVAColorRegion 支持多种透明区域布局方式

typedef NS_ENUM(NSInteger,YYEVAColorRegion) {
    YYEVAColorRegion_NoSpecify = 999,              ///< 默认没指定模式，将会自动检测
    YYEVAColorRegion_Invaile = 0,                 ///< 检测失败
    YYEVAColorRegion_NormalMP4,                   ///< 普通MP4，没透明区域
    YYEVAColorRegion_AlphaMP4_LeftColorRightGray, ///< 左彩色右透明
    YYEVAColorRegion_AlphaMP4_LeftGrayRightColor, ///< 左透明右彩色
    YYEVAColorRegion_AlphaMP4_TopColorBottomGray, ///< 上彩色下透明
    YYEVAColorRegion_AlphaMP4_TopGrayBottomColor,  ///< 上透明下彩色
    YYEVAColorRegion_AlphaMP4_alphaHalfRightTop      ///< alpha区域是rgb区域的一半，在右上角
};