BiliRoamingX项目中AVIF图像格式禁用问题的技术分析

BiliRoamingX项目中AVIF图像格式禁用问题的技术分析

BiliRoamingX-integrations BiliRoamingX integrations powered by revanced. 项目地址: https://gitcode.com/gh_mirrors/bi/BiliRoamingX-integrations

问题背景

在BiliRoamingX项目中，用户反馈了一个关于AVIF图像格式的兼容性问题。当用户在哔哩哔哩客户端中禁用AVIF图像格式支持后，部分特定场景下的图像无法正常加载，特别是直播间粉丝牌左侧的荣耀等级图标。

技术细节分析

AVIF是一种基于AV1视频编码的图像格式，相比传统格式如JPEG和PNG，它能提供更好的压缩效率和图像质量。哔哩哔哩客户端在7.75.0版本中引入了对AVIF格式的支持，但部分设备可能由于硬件或软件限制无法正确解码这种新格式。

问题现象

当用户在BiliRoamingX中启用"禁用AVIF图像格式"功能后，虽然大部分图像能正常回退到传统格式加载，但某些特定场景下的图像仍然无法显示，特别是：

• 直播间粉丝牌左侧的荣耀等级图标（蓝色图片）
• 部分API返回的AVIF格式图像
• 资源包中内置的AVIF格式图像

根本原因

经过分析，问题主要源于以下几个方面：

1. 不完全的格式禁用：虽然禁用了AVIF支持，但部分API仍然会返回AVIF格式的URL，特别是那些以"@*.avif"结尾的图片链接。

2. 资源包内嵌问题：某些AVIF格式图像直接内嵌在应用资源包中，无法通过简单的URL重写来解决。

3. 客户端硬编码：部分图像加载逻辑在客户端代码中被硬编码为优先使用AVIF格式，缺乏完善的回退机制。

解决方案探讨

针对这个问题，技术社区提出了几种可能的解决方案：

1. URL重写方案：将所有*.hdslb.com域名下以"@*.avif"结尾的URL重写为.webp格式。这种方法可以解决大部分API返回的AVIF图像问题，但对资源包内的图像无效。

2. 客户端修改方案：通过修改APK实现更彻底的AVIF禁用：

   • 将ff_enable_image_avif默认值设为false
   • 将ff_noavif_enable默认值设为true
   • 修改com.bilibili.gripper.image.avif.AvifSelfCheck类的execute方法，强制返回设备不支持AVIF的逻辑

3. 完善回退机制：在图像加载逻辑中增加更完善的格式回退机制，当AVIF加载失败时自动尝试加载其他格式的版本。

技术实现建议

对于想要自行解决这个问题的开发者，可以考虑以下实现路径：

1. Hook图像加载逻辑：通过Xposed或类似框架hook哔哩哔哩客户端的图像加载模块，在加载前对URL进行检测和修改。

2. 修改客户端配置：直接修改客户端的配置参数，强制禁用AVIF支持的所有相关开关。

3. 资源替换：对于内嵌在资源包中的AVIF图像，可以尝试用相同内容的WebP或PNG版本进行替换。

兼容性考量

在实施解决方案时，需要考虑不同版本客户端的兼容性：

• 不同哔哩哔哩客户端版本可能使用不同的图像加载逻辑
• MIUI系统可能有自己的图像解码实现
• Android版本差异可能导致不同的格式支持情况

结论

AVIF作为一种新兴图像格式，在带来优势的同时也带来了兼容性挑战。BiliRoamingX项目中的这个案例展示了在客户端中引入新格式时需要考虑完善的回退机制和配置选项的重要性。对于用户和开发者来说，理解这些技术细节有助于更好地解决类似问题，提升使用体验。

BiliRoamingX-integrations BiliRoamingX integrations powered by revanced. 项目地址: https://gitcode.com/gh_mirrors/bi/BiliRoamingX-integrations