付费墙编辑工具的 Media 分类下包含三种媒体元素类型：Image（图片）、Video（视频）和 Icon（图标）。

图片

上传 .JPG、.PNG 或 .WEBP 文件，大小不超过 20 MB。

不支持动态 GIF 和 WEBP。如需添加动效，请改用 视频 元素。

• Content mode — 控制在设置高度时图片填充容器的方式。请参阅 图片尺寸。
• Use custom media ID — 请参阅下方 自定义媒体 ID。

图片尺寸

图片有其固有比例，而你设置的容器尺寸可能与之不符。先设置宽度，再决定高度：

• 自动高度。图片保持原有比例：高度由所设宽度自动推算。内容模式会随之关闭，因为无需裁剪。
• 固定或填充高度。容器拥有独立的比例，此时内容模式用于处理尺寸不匹配的情况：
  • 适应。将整张图片缩放至容器内，留有空白区域。
  • 填充。裁剪超出部分。默认选项。

要让图片在任意屏幕宽度下都不被裁剪，请将宽度设置为 Fill，高度设置为 Auto。如果固定高度，顶部和底部的裁剪效果会随屏幕尺寸变化而改变。

视频

上传 .MP4 或 .WEBM 文件，大小不超过 50 MB，时长不超过 30 秒。视频最低分辨率为 640x640 像素。

• Aspect — 控制视频在设置高度后填充容器的方式。详见视频尺寸。
• Loop — 循环播放视频。默认开启。
• Use custom media ID — 详见下方自定义媒体 ID。

视频在编辑器预览中不会播放——画布仅显示静帧。在设备上运行时，视频默认静音播放。开启 Loop 后，视频将无限循环。

视频大小调整

视频有其自身的比例，而你为其设置的容器尺寸可能与之不符。高度属性决定了处理方式：

• Hug height。高度跟随视频自身比例自动调整。
• Fixed 或 Fill height。通过 Aspect 属性解决尺寸不匹配的问题：
  • Fit。将整个视频缩放至容器内，多余空间留白。
  • Fill。裁剪超出部分。默认设置。

当 Adapty 无法读取上传视频的尺寸时，会弹出警告：“Could not determine video dimensions. Set a fixed height to ensure the video displays correctly.”请为视频设置固定高度，或确保其容器具有固定高度，否则视频高度可能会折叠为 0。

视频播放结束时触发动作

视频元素支持 On playback finished 触发器，当视频播放到结尾时触发。在 Interactions 面板中进行设置，可跳转到其他页面、显示 CTA，或执行任何其他动作。

图标

从内置的 Tabler Icons 库中选取图标，提供两种视觉风格，图标数量丰富：

• Stroke — 仅描边轮廓。
• Filled — 实心填充。

在选择器中通过关键词搜索图标。在 Color 选择器中设置图标颜色——可选择已保存的颜色样式，也可自定义颜色。

本地化媒体

图片和视频元素可以为每种语言设置不同的文件：

1. 如果 Localizations 面板已打开，请先关闭它，以显示属性面板。
2. 在底部工具栏中，将 Locale 设置为目标语言。
3. 选择该元素，然后在属性面板中上传本地化文件。
4. 完成后，将 Locale 切换回默认语言。在其他语言处于激活状态时，在属性面板中编辑的文字会修改该语言的翻译内容。

在没有专属文件的语言环境中，该元素会显示默认语言环境的文件。你也可以在 Localizations 面板中为每种语言环境上传对应的文件。

限制

以下内容无法进行本地化：

• 图标
• 屏幕或容器的 Fill — 这包括屏幕背景以及容器自身的背景图片或视频，设置位置为 Fill 部分。如需按语言区域切换图片或视频，请将其作为独立的 Image 或 Video 元素添加 — 这些元素支持按语言区域指定文件，详见 本地化媒体文件。
• 自定义媒体 ID

自定义媒体 ID

为图片或视频元素添加自定义媒体 ID，即可在运行时从应用代码中动态替换该媒体内容。这适用于个性化视觉效果——例如，显示用户选择的头像。

你在 Flow & Paywall Builder 中上传的媒体文件将作为备用内容。如果你的代码在运行时未提供该 ID 对应的媒体，则会渲染备用内容。

自定义媒体 ID 只能将文件替换为同类型的文件——图片换图片，视频换视频。若类型不匹配，则显示备用内容。

要在图片或视频元素上启用自定义媒体 ID：

1. 勾选上传区域下方的 Use custom media ID 复选框。
2. 输入媒体 ID。
3. 上传备用图片或视频。

在应用代码中，通过 ID 获取媒体资源——请参阅 自定义资源 了解 SDK API。