Overview

Element

Effect

转场元素

转场在两个连续的视频或图像元素之间创建平滑的视觉效果。

时间限制

  • 重叠要求：转场通过将一个元素（preNodeId）的结束与另一个元素（postNodeId）的开始重叠来工作
  • 最大持续时间：转场持续时间不能超过两个元素之间可用的重叠时间
  • 定位：转场的 start 时间应与重叠期间对齐

转场持续时间限制

转场的最大持续时间由以下公式确定：

maxDuration = min(
  availableEndTime_of_preNode,
  availableStartTime_of_postNode
)

如果您设置的持续时间超过此限制，转场可能无法正确渲染。

属性类型必需示例值范围描述
preNodeIdstringtrue--转场开始时前一个元素的唯一标识符。
postNodeIdstringtrue--转场结束时后一个元素的唯一标识符。
transitionTypestringtrue-directionalwarp, directionalwipe, Bounce, BowTieHorizontal, BowTieVertical, ButterflyWaveScrawler, CircleCrop, ColourDistance, CrazyParametricFun, Directional, DoomScreenTransition, Dreamy, DreamyZoom, GridFlip, InvertedPageCurl, LinearBlur, Mosaic, PolkaDotsCurtain, Radial, SimpleZoom, StereoViewer, Swirl, WaterDrop, ZoomInCircles, angular, burn, cannabisleaf, circle, colorphase, crosshatch, crosswarp, cube, displacement, doorway, fade, fadecolor, fadegrayscale, flyeye, heart, hexagonalize, kaleidoscope, luma, luminance_melt, morph, multiply_blend, pinwheel, pixelize, polar_function, ripple, rotate_scale_fade, squareswire, squeeze, swap, undulatingBurnOut, wind, windowblinds, windowslice, wipeDown, wipeLeft, wipeRight, wipeUp应用的转场效果类型。名称区分大小写。

重要说明：

  • preNodeId 和 postNodeId 必须引用 view 数组中存在的元素
  • 区分大小写：转场类型名称区分大小写。请使用上述列出的确切名称
  • 命名约定：某些转场使用 PascalCase（例如，Bounce，CircleCrop），其他则使用小写（例如，fade，wipeLeft）。请使用显示的确切名称
  • 持续时间限制：确保转场持续时间不超过元素之间的重叠时间
  • 转场元素本身不需要 trackIndex - 它从引用的元素中获取时间

示例用例：

  • fade 转场提供经典的交叉溶解效果，适用于两个视频
  • wipeLeft 创建从右到左的滑动擦拭效果
  • Bounce 在转场过程中增加了一种有趣的弹性反弹
  • 自定义转场如 directionalwarp 创建扭曲效果

示例：视频转场

两个视频的 2 秒转场重叠：

transitionElement.json
{
"view": [
  {
    "id": "435862f1-2358-464d-b379-26f4b63b12e3",
    "type": "Video",
    "start": 0,
    "duration": 10.218542,
    "trackIndex": 0,
    "externalUrl": "https://example.com/video1.mp4",
    "ext": "mp4"
  },
  {
    "id": "2b82ffe3-7c6e-4d28-9c11-9e3de94c5a49",
    "type": "Video",
    "start": 8.218542,
    "duration": 15,
    "trackIndex": 0,
    "externalUrl": "https://example.com/video2.mp4",
    "ext": "mp4"
  }
],
"transition": [
  {
    "id": "52b20852-e260-41aa-afab-70c22e20f62b",
    "type": "Transition",
    "start": 8.218542,
    "duration": 2,
    "preNodeId": "435862f1-2358-464d-b379-26f4b63b12e3",
    "postNodeId": "2b82ffe3-7c6e-4d28-9c11-9e3de94c5a49",
    "transitionType": "directionalwarp"
  }
]
}