SDWebImage 如何用 SDAnimatedImagePlayer 在无 UIView 环境下播放动画图片【免费下载链接】SDWebImageAsynchronous image downloader with cache support as a UIImageView category项目地址: https://gitcode.com/GitHub_Trending/sd/SDWebImage当运行环境里没有UIImageView可用时README 中给出的典型例子是WatchKit和CALayerSDAnimatedImageView就无法直接使用动画 GIF/APNG 也就没有现成的播放载体。SDWebImage 5.x 把SDAnimatedImageView背后的播放引擎抽成了独立类SDAnimatedImagePlayer它按帧向动画数据源取帧通过animationFrameHandler把每一帧的UIImage回调给你由你自己决定把这一帧画到哪里——WKInterfaceImage、CALayer或任何自定义渲染面。本文的操作路径来自仓库内的头文件、实现和 Watch Demo 扩展源码读者可以在无 UIView 的环境中完成一次完整的动画播放。适用前提以下事实来自 README.md 的 Requirements 一节安装和运行前先确认环境满足平台iOS 9.0 / tvOS 9.0 / watchOS 2.0 / macOS 10.11Catalyst 需 10.15/ visionOS 1.0Xcode 15.0通过 CocoaPods 安装pod SDWebImage, ~ 5.0README 同时提供 Swift Package Manager 安装方式见该文档 Installation with Swift Package Manager 小节。另外两个硬约束来自 SDAnimatedImagePlayer.h 与 SDAnimatedImagePlayer.m播放器的数据源必须是SDAnimatedImageProvider协议实现官方给出的例子是SDAnimatedImage、SDImageGIFCoder等若 provider 的animatedImageFrameCount小于 1initWithProvider:直接返回nil拿不到播放器实例。也就是说单帧图片不能走这条路径需要在创建前自行检查帧数并保留回退逻辑SDAnimatedImage.h 中也有同样提醒帧数 ≤ 1 时协议方法会返回 nil 或 0 值。播放器的工作机制SDAnimatedImagePlayer内部用SDDisplayLink挂在主 RunLoop 上逐帧驱动见实现文件中displayLink相关代码。你只需要关心接口契约状态属性均支持 KVOcurrentFrame当前帧图片、currentFrameIndex当前帧索引从 0 起、currentLoopCount本轮播放以来的循环次数、isPlaying是否在播放回调animationFrameHandler在每帧变化时触发参数是帧索引和帧图片animationLoopHandler在每轮循环结束时触发可控参数playbackRate默认 1.00.0-1.0减速 1.0加速0.0停止负值暂不支持、playbackModeNormal / Reverse / Bounce / ReversedBounce 四种播放模式、totalLoopCount默认取动画自身的循环次数0 表示无限循环、maxBufferSize帧缓冲上限0表示按当前内存自动计算1表示不缓存缓冲NSUIntegerMax表示全部缓存、runLoopMode默认多核设备用NSRunLoopCommonModes单核设备用NSDefaultRunLoopMode。SDAnimatedImageView的player属性暴露的就是同一个类注释里写明它驱动 Animated ImageView 或任何渲染用途比如 CALayer/WatchKit/SwiftUI 渲染可以把它当作理解该类的参照。完整操作步骤以 WatchKit 为例仓库自带了一份完整可用的示例Examples/SDWebImage Watch Demo Extension/InterfaceController.m。下面按该示例拆解成可复用的步骤示例中的 URL 是仓库 Demo 自带的演示地址实际使用请替换为你自己的图片地址。第 1 步拿到SDAnimatedImage实例Demo 通过分类方法从网络加载并用 context 指定解码出的动画图类NSString *urlString https://raw.githubusercontent.com/liyong03/YLGIFImage/master/YLGIFImageDemo/YLGIFImageDemo/joy.gif; // 仓库 Demo 示例地址替换为自己的地址 [wself.animatedImageInterface sd_setImageWithURL:[NSURL URLWithString:urlString] placeholderImage:nil options:SDWebImageProgressiveLoad context:{SDWebImageContextAnimatedImageClass : SDAnimatedImage.class} progress:nil completed:^(UIImage * _Nullable image, NSError * _Nullable error, SDImageCacheType cacheType, NSURL * _Nullable imageURL) { // 见第 2 步 }];本地资源同样可行SDAnimatedImage提供imageNamed:、imageWithData:、initWithData:scale:等创建入口。第 2 步校验类型并创建播放器在 completed 回调里先确认解码结果确实是SDAnimatedImage再创建播放器if (![image isKindOfClass:[SDAnimatedImage class]]) { return; } self.player [SDAnimatedImagePlayer playerWithProvider:(SDAnimatedImage *)image];第 3 步在animationFrameHandler里渲染帧把每一帧交给你的渲染面。WatchKit 下就是对WKInterfaceImage调setImage:__weak typeof(self) wself self; self.player.animationFrameHandler ^(NSUInteger index, UIImage * _Nonnull frame) { [wself.animatedImageInterface setImage:frame]; };换成CALayer时这里改为更新layer.contents即可——播放器不关心帧被画到哪里这是它与SDAnimatedImageView的本质区别。第 4 步启动播放[self.player startPlaying];startPlaying同时承担恢复先前暂停的动画的职责pausePlaying保留当前帧索引和循环计数stopPlaying则会把帧索引和循环计数重置。验证播放是否生效文档给出了三类可直接核对的判断方式isPlayingstartPlaying之后读取该属性应为YESstopPlaying/pausePlaying之后为NOKVO 状态currentFrameIndex、currentLoopCount均支持 KVO播放过程中索引应逐帧变化、循环计数每轮 1animationLoopHandler每轮也会回调一次视觉验证animationFrameHandler持续被调用WKInterfaceImage上的画面逐帧变化Demo 中正是以此验证 389 帧 GIF 在 Apple Watch 上的播放。需要精确控制时可用seekToFrameAtIndex:loopCount:跳到指定帧帧索引超出totalFrameCount时调用会被忽略以及clearFrameBuffer手动清空帧缓冲默认pausePlaying/stopPlaying不会清缓冲缓存会保留给下次启动用。参数取舍与限制内存敏感设备上的帧缓冲Demo 源码中有一段值得注意的注释——用WKInterfaceImage的简单动画方式播放该 389 帧 GIF 时Apple Watch 会消耗 800MB 以上内存并触发 OOM而SDAnimatedImagePlayer路径与SDAnimatedImageView同后端是 Demo 推荐的做法。这是仓库 Demo 给出的实测描述非通用承诺。maxBufferSize解码开销高的格式如 Animated WebP 软解下用它调节缓冲帧数取值语义见上文可控参数。渐进式加载provider 内容可以是渐进更新的progressive animation但新帧到达后需要你自行更新totalFrameCount配合seekToFrameAtIndex:loopCount:可跳过指定帧。播放速率playbackRate为负目前不受支持会停止动画反向播放请使用playbackMode中的 Reverse/Bounce 模式。播放器生命周期实现中在dealloc时会自动注销帧池持有player的视图控制器退出时释放即可页面不可见时建议调用stopPlaying停止驱动。完成以上步骤后无 UIView 环境下就能稳定驱动动画图片类型校验通过、isPlaying为YES且帧画面逐帧更新即为播放成功。若要接入SDProgressiveImageCoder等高级解码路径可参考 SDAnimatedImage.h 中initWithAnimatedCoder:scale:的说明。【免费下载链接】SDWebImageAsynchronous image downloader with cache support as a UIImageView category项目地址: https://gitcode.com/GitHub_Trending/sd/SDWebImage创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 SDWebImage 如何用 SDAnimatedImagePlayer 在无 UIView 环境下播放动画图片？
SDWebImage 如何用 SDAnimatedImagePlayer 在无 UIView 环境下播放动画图片【免费下载链接】SDWebImageAsynchronous image downloader with cache support as a UIImageView category项目地址: https://gitcode.com/GitHub_Trending/sd/SDWebImage当运行环境里没有UIImageView可用时README 中给出的典型例子是WatchKit和CALayerSDAnimatedImageView就无法直接使用动画 GIF/APNG 也就没有现成的播放载体。SDWebImage 5.x 把SDAnimatedImageView背后的播放引擎抽成了独立类SDAnimatedImagePlayer它按帧向动画数据源取帧通过animationFrameHandler把每一帧的UIImage回调给你由你自己决定把这一帧画到哪里——WKInterfaceImage、CALayer或任何自定义渲染面。本文的操作路径来自仓库内的头文件、实现和 Watch Demo 扩展源码读者可以在无 UIView 的环境中完成一次完整的动画播放。适用前提以下事实来自 README.md 的 Requirements 一节安装和运行前先确认环境满足平台iOS 9.0 / tvOS 9.0 / watchOS 2.0 / macOS 10.11Catalyst 需 10.15/ visionOS 1.0Xcode 15.0通过 CocoaPods 安装pod SDWebImage, ~ 5.0README 同时提供 Swift Package Manager 安装方式见该文档 Installation with Swift Package Manager 小节。另外两个硬约束来自 SDAnimatedImagePlayer.h 与 SDAnimatedImagePlayer.m播放器的数据源必须是SDAnimatedImageProvider协议实现官方给出的例子是SDAnimatedImage、SDImageGIFCoder等若 provider 的animatedImageFrameCount小于 1initWithProvider:直接返回nil拿不到播放器实例。也就是说单帧图片不能走这条路径需要在创建前自行检查帧数并保留回退逻辑SDAnimatedImage.h 中也有同样提醒帧数 ≤ 1 时协议方法会返回 nil 或 0 值。播放器的工作机制SDAnimatedImagePlayer内部用SDDisplayLink挂在主 RunLoop 上逐帧驱动见实现文件中displayLink相关代码。你只需要关心接口契约状态属性均支持 KVOcurrentFrame当前帧图片、currentFrameIndex当前帧索引从 0 起、currentLoopCount本轮播放以来的循环次数、isPlaying是否在播放回调animationFrameHandler在每帧变化时触发参数是帧索引和帧图片animationLoopHandler在每轮循环结束时触发可控参数playbackRate默认 1.00.0-1.0减速 1.0加速0.0停止负值暂不支持、playbackModeNormal / Reverse / Bounce / ReversedBounce 四种播放模式、totalLoopCount默认取动画自身的循环次数0 表示无限循环、maxBufferSize帧缓冲上限0表示按当前内存自动计算1表示不缓存缓冲NSUIntegerMax表示全部缓存、runLoopMode默认多核设备用NSRunLoopCommonModes单核设备用NSDefaultRunLoopMode。SDAnimatedImageView的player属性暴露的就是同一个类注释里写明它驱动 Animated ImageView 或任何渲染用途比如 CALayer/WatchKit/SwiftUI 渲染可以把它当作理解该类的参照。完整操作步骤以 WatchKit 为例仓库自带了一份完整可用的示例Examples/SDWebImage Watch Demo Extension/InterfaceController.m。下面按该示例拆解成可复用的步骤示例中的 URL 是仓库 Demo 自带的演示地址实际使用请替换为你自己的图片地址。第 1 步拿到SDAnimatedImage实例Demo 通过分类方法从网络加载并用 context 指定解码出的动画图类NSString *urlString https://raw.githubusercontent.com/liyong03/YLGIFImage/master/YLGIFImageDemo/YLGIFImageDemo/joy.gif; // 仓库 Demo 示例地址替换为自己的地址 [wself.animatedImageInterface sd_setImageWithURL:[NSURL URLWithString:urlString] placeholderImage:nil options:SDWebImageProgressiveLoad context:{SDWebImageContextAnimatedImageClass : SDAnimatedImage.class} progress:nil completed:^(UIImage * _Nullable image, NSError * _Nullable error, SDImageCacheType cacheType, NSURL * _Nullable imageURL) { // 见第 2 步 }];本地资源同样可行SDAnimatedImage提供imageNamed:、imageWithData:、initWithData:scale:等创建入口。第 2 步校验类型并创建播放器在 completed 回调里先确认解码结果确实是SDAnimatedImage再创建播放器if (![image isKindOfClass:[SDAnimatedImage class]]) { return; } self.player [SDAnimatedImagePlayer playerWithProvider:(SDAnimatedImage *)image];第 3 步在animationFrameHandler里渲染帧把每一帧交给你的渲染面。WatchKit 下就是对WKInterfaceImage调setImage:__weak typeof(self) wself self; self.player.animationFrameHandler ^(NSUInteger index, UIImage * _Nonnull frame) { [wself.animatedImageInterface setImage:frame]; };换成CALayer时这里改为更新layer.contents即可——播放器不关心帧被画到哪里这是它与SDAnimatedImageView的本质区别。第 4 步启动播放[self.player startPlaying];startPlaying同时承担恢复先前暂停的动画的职责pausePlaying保留当前帧索引和循环计数stopPlaying则会把帧索引和循环计数重置。验证播放是否生效文档给出了三类可直接核对的判断方式isPlayingstartPlaying之后读取该属性应为YESstopPlaying/pausePlaying之后为NOKVO 状态currentFrameIndex、currentLoopCount均支持 KVO播放过程中索引应逐帧变化、循环计数每轮 1animationLoopHandler每轮也会回调一次视觉验证animationFrameHandler持续被调用WKInterfaceImage上的画面逐帧变化Demo 中正是以此验证 389 帧 GIF 在 Apple Watch 上的播放。需要精确控制时可用seekToFrameAtIndex:loopCount:跳到指定帧帧索引超出totalFrameCount时调用会被忽略以及clearFrameBuffer手动清空帧缓冲默认pausePlaying/stopPlaying不会清缓冲缓存会保留给下次启动用。参数取舍与限制内存敏感设备上的帧缓冲Demo 源码中有一段值得注意的注释——用WKInterfaceImage的简单动画方式播放该 389 帧 GIF 时Apple Watch 会消耗 800MB 以上内存并触发 OOM而SDAnimatedImagePlayer路径与SDAnimatedImageView同后端是 Demo 推荐的做法。这是仓库 Demo 给出的实测描述非通用承诺。maxBufferSize解码开销高的格式如 Animated WebP 软解下用它调节缓冲帧数取值语义见上文可控参数。渐进式加载provider 内容可以是渐进更新的progressive animation但新帧到达后需要你自行更新totalFrameCount配合seekToFrameAtIndex:loopCount:可跳过指定帧。播放速率playbackRate为负目前不受支持会停止动画反向播放请使用playbackMode中的 Reverse/Bounce 模式。播放器生命周期实现中在dealloc时会自动注销帧池持有player的视图控制器退出时释放即可页面不可见时建议调用stopPlaying停止驱动。完成以上步骤后无 UIView 环境下就能稳定驱动动画图片类型校验通过、isPlaying为YES且帧画面逐帧更新即为播放成功。若要接入SDProgressiveImageCoder等高级解码路径可参考 SDAnimatedImage.h 中initWithAnimatedCoder:scale:的说明。【免费下载链接】SDWebImageAsynchronous image downloader with cache support as a UIImageView category项目地址: https://gitcode.com/GitHub_Trending/sd/SDWebImage创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考