IINA播放HDR视频发白的首要原因是HDR元数据未直通，需勾选「启用HDR元数据直通」；若灰显则检查片源HDR格式；必须选用「VideoToolbox (Metal)」输出并设BT.2020/Full；关闭系统原彩显示、夜览、自动亮度及HDR开关；终端写入HDR10参数或编辑mpv.conf启用动态峰值计算；禁用显示器OSD动态增强功能并重插线缆。
确认IINA已启用HDR元数据直通
Mac上IINA播放HDR视频发白，首要原因是播放器未正确传递HDR元数据，导致系统误按SDR方式解码——画面失去暗部细节、高光糊成一片白。这与显示器或片源无关，是信号链路中断所致。
打开IINA → 右键播放界面 →「设置」→「视频」→「色彩管理」→ 勾选【「启用HDR元数据直通」】。
若该选项灰显，说明当前视频未被识别为HDR格式：暂停播放 → 右键 →「信息」→ 查看「HDR format」字段是否显示「HDR10」或「HLG」；若为空或显示「None」，需检查文件是否真为HDR编码（可用MediaInfo验证）。
强制IINA使用macOS原生HDR渲染路径
IINA默认走mpv的OpenGL/Vulkan后端，在macOS上易绕过系统HDR管线，造成色彩空间错位。必须切换至Apple VideoToolbox专属路径。
右键播放界面 →「设置」→「视频」→「输出」→「视频输出」下拉菜单中选择【「VideoToolbox (Metal)」】。
接着在同页向下找到「色彩空间」→ 将「YUV色彩空间」设为【「BT.2020」】、「RGB范围」设为【「Full」】；这两项不匹配会导致BT.2020色域被压缩进sRGB容器，直接引发泛白。
重启IINA生效——仅重载视频无效，必须完全退出再启动。
关闭macOS系统级HDR干扰项
即便IINA配置正确，macOS的「原彩显示」「夜览」「自动亮度」仍会动态篡改输出信号，把HDR帧强行塞进SDR伽马曲线，结果就是整屏漂白。
第一步：点击屏幕右上角控制中心 → 长按「亮度」滑块 → 关闭【「原彩显示」】和【「夜览」】。
第二步：进入「系统设置」→「显示器」→ 取消勾选【「自动调节亮度」】→ 向下滚动到「高动态范围」区域 → 确保【「使用HDR」开关为关闭状态】。
注意：这里不是要关掉HDR内容播放，而是关掉系统对桌面UI的伪HDR注入——它会污染IINA独占的Metal渲染上下文。
校准IINA内部亮度映射曲线
发白常因PQ（ST 2084）曲线解码时黑电平抬升、白峰值溢出。IINA不提供图形化HDR校准面板，但可通过配置文件精准干预。
方法一：终端写入关键参数
打开「终端.app」→ 输入：
defaults write me.iina IINAPlayerVideoToolboxUseHDR10 true
defaults write me.iina IINAPlayerVideoToolboxHDR10MaxCLL 1000
defaults write me.iina IINAPlayerVideoToolboxHDR10MinCLL 0
方法二：手动编辑mpv配置
在访达中按Cmd+Shift+G → 输入~/.config/mpv/mpv.conf → 在文件末尾添加：
video-sync=display-resample
hdr-compute-peak=yes
hdr-compute-avg=yes
保存后重启IINA。
这两组参数强制IINA以1000尼特为基准解析PQ曲线，并启用动态峰值计算，避免将600尼特显示器误判为1000尼特而整体提亮。
禁用显示器OSD动态增强功能
很多用户调完IINA和系统仍发白，问题其实在显示器自己——「动态对比度」「自动亮度」「电影模式」等OSD功能会实时检测画面平均亮度并提亮暗场，把HDR应有的深邃黑场拉成雾状灰白。
按下显示器物理Menu键 → 进入「图像设置」→ 找到「动态对比度」→ 设为【「关闭」】；
再进入「高级设置」→ 将「自动亮度调节」→ 设为【「关闭」】；
最后进入「显示模式」→ 选择【「标准」或「sRGB」】，绝不可选「影院」「HDR」等厂商自定义模式——那些模式会覆盖IINA输出的原始HDR元数据。
调完立即拔插HDMI/DP线缆，让显示器重新读取EDID中的原生能力声明，否则OSD设置可能缓存旧参数。
