摘要：Marker Key （标记键属性和方法）组可以用于操作和获取标记相关的信息，诸如标记时间、注释、章节、URL 等。这些信息通常用于文本图层动态显示、动画驱动或交互式内容的生成。
Marker Key （标记键属性和方法）组可以用于操作和获取标记相关的信息，诸如标记时间、注释、章节、URL 等。这些信息通常用于文本图层动态显示、动画驱动或交互式内容的生成。
marker 是一个对象。
//示例 1：第一个标记的时间marker.key(1).time//示例 2：综合m = thisLayer.marker.nearestKey(time);s = "time:" + timeToCurrentFormat(m.time) + "\r" +"duration: " + m.duration + "\r" +"key index: " + m.index + "\r" +"comment:" + m.comment + "\r" +"chapter:" + m.chapter + "\r" +"URL:" + m.url + "\r" +"frame target: " + m.frameTarget + "\r" +"cue point name: " + m.cuePointName + "\r" +"Event cue point? " + m.eventCuePoint + "\r";for (param in m.parameters){s += "parameter: " + param + " value: " + m.parameters[param] + "\r";}snearestKey( time )
返回与指定时间最接近的标记键。
参数：
time : 时间值，表示要查找标记的时间。
返回值 ：Object，返回一个 MarkerKey 对象，表示最接近指定时间的标记。
应用：
// 示例：获取最接近当前时间的图层标记，并显示它的时间和注释内容。m = thisLayer.marker.nearestKey(time);s = "time: " + timeToCurrentFormat(m.time) + "\r" +"comment: " + m.comment + "\r";scomment
获取“标记”对话框中的注释内容字段。
返回值 ：String，标记的注释。
应用：
// 示例：获取并返回与当前时间最接近的标记的评论内容m = thisLayer.marker.nearestKey(time);m.commentchapter
获取“标记”对话框中的章节内容字段。
返回值 ：String，标记的章节名称。
应用：
// 示例：返回与当前时间最接近的标记的章节名m = thisLayer.marker.nearestKey(time);m.chapterurl
获取“标记”对话框中的 URL 内容字段。
返回值 ：String，标记的 URL 地址。
应用：
// 示例：返回与当前时间最接近的标记的章节名m = thisLayer.marker.nearestKey(time);m.urlframeTarget
获取“标记”对话框中的帧目标内容字段。
返回值 ：String，标记的帧目标。
应用：
// 示例：获取并返回最接近当前时间的标记中的帧目标内容m = thisLayer.marker.nearestKey(time);m.frameTargetprotectedRegion
获取“合成标记”对话框中的受保护区域内容字段。
返回值 ：Boolean，如果为 True 时，表示该标记作为受保护的区域存在。
应用：
// 示例：返回第一个标记是否作为受保护的区域存在m = thisComp.marker.key(1);m.protectedRegioneventCuePoint
判断标记是否为事件提示点。
返回值 ：Boolean，如果为 true，则表示该标记为事件类型的提示点；如果为 false，则表示为导航类型的提示点。
应用：
// 示例：最接近当前时间的标记是否为事件 Cue 点m = thisLayer.marker.nearestKey(time);m.eventCuePointcuePointName
获取“标记”对话框中的提示点名称内容字段。
返回值 ：String，标记的提示点名称。
应用：
// 示例：获取并返回最接近当前时间的标记的 Cue Point 名称m = thisLayer.marker.nearestKey(time);m.cuePointNameparameters
获取一个包含标记参数名称及其对应值的关联数组。
返回值 ：Object，包含标记的所有参数名称及其对应值。
应用：
//示例 1：如果有名为“背景颜色”的参数，则可以使用以下表达式在最近的标记中访问其值。thisComp.marker.nearestKey(time).parameters["背景颜色"]//示例 2：遍历并显示与当前标记相关的所有参数及其值m = thisLayer.marker.nearestKey(time);s = "";for (param in m.parameters) {s += "parameter: " + param + " value: " + m.parameters[param] + "\r";}sduration
获取标记的持续时间。
返回值 ：Number，标记的持续时间值，以秒为单位。
应用：
// 示例：获取当前时间点最接近的标记的持续时间值m = thisLayer.marker.nearestKey(time);m.durationtime
获取标记的时间值。
返回值 ：Number，标记的时间，以秒为单位，表示标记在时间轴上的位置。
应用：
// 示例：获取当前时间点最接近的标记的时间值m = thisLayer.marker.nearestKey(time);m.time获取标记的顺序索引值。
返回值 ：Number，标记的索引值。
应用：
// 示例：返回最接近当前时间的标记的索引值m = thisLayer.marker.nearestKey(time);m.index“点赞有美意，赞赏是鼓励”
来源：芬芬课堂
