BiliRoamingX项目AVIF图像格式兼容性问题分析与解决方案

问题背景

在BiliRoamingX项目中，用户反馈了一个关于AVIF图像格式兼容性的问题。当用户在哔哩哔哩客户端中禁用AVIF图像格式支持后，部分图像资源无法正常加载，特别是直播间粉丝牌左侧的荣耀等级图标显示异常。这个问题主要出现在MIUI14系统、Android 13环境下运行的哔哩哔哩粉版7.75.0版本中。

技术分析

AVIF是一种基于AV1视频编码的图像格式，具有优秀的压缩效率和图像质量。哔哩哔哩客户端为了优化资源加载速度和节省带宽，部分采用了AVIF格式的图像资源。然而，并非所有设备和系统都能完美支持AVIF格式，特别是较旧的Android版本。

通过分析问题现象和日志，我们发现：

1. 即使禁用了AVIF格式支持(ff_enable_image_avif=false)，客户端仍有部分API会返回AVIF格式的图像URL
2. 某些资源包中直接包含了AVIF格式的图像资源
3. 客户端对AVIF格式的兼容性检查逻辑不够完善

问题根源

深入分析后，我们确定了几个关键点：

1. URL层面的问题：部分图像资源URL以@*.avif结尾，客户端在禁用AVIF后没有自动回退到其他格式
2. 资源包内嵌问题：某些资源包直接包含了AVIF格式的二进制数据，绕过URL检测机制
3. 兼容性检查不彻底：com.bilibili.gripper.image.avif.AvifSelfCheck类的执行逻辑未能正确处理禁用AVIF的情况

解决方案

针对上述问题，我们提出以下解决方案：

1. URL重写机制：

   • 对于*.hdslb.com域名下的资源
   • 自动将@*.avif结尾的URL替换为.webp格式
   • 确保在禁用AVIF时能回退到广泛支持的WebP格式

2. 资源包处理：

   • 修改客户端资源加载逻辑
   • 当检测到资源包内包含AVIF数据且AVIF被禁用时
   • 尝试加载备用格式资源或显示占位图

3. 兼容性检查增强：

   • 修改AvifSelfCheck类的execute方法
   • 当ff_enable_image_avif=false时直接返回"设备不支持"状态
   • 确保客户端不会尝试加载AVIF格式资源

实现细节

对于希望自行修改客户端的用户，可以采取以下步骤：

1. 将ff_enable_image_avif的默认值设为false
2. 将ff_noavif_enable的默认值设为true
3. 修改AvifSelfCheck类的execute方法，强制返回不支持AVIF的逻辑

这些修改可以有效解决禁用AVIF后部分图像无法显示的问题，同时保持客户端的其他功能不受影响。

总结

AVIF作为一种新兴图像格式，在带来性能优势的同时也带来了兼容性挑战。BiliRoamingX项目通过细致的格式检测和回退机制，确保了在各种设备环境下的稳定运行。这个案例也提醒我们，在引入新技术时需要全面考虑兼容性问题，并建立完善的回退机制。