Devtools Animations: Support multiple frames in the animation timeline

Source/devtools/protocol.json

 {
     "version": { "major": "1", "minor": "1" },
     "domains": [{
         "domain": "Inspector",
         "hidden": true,
         "types": [],
         "commands": [
             {
                 "name": "enable",
                 "description": "Enables inspector domain notifications."
@@ skipping 4815 matching lines @@
                 ],
                 "handlers": ["browser", "frontend"]
             }
         ]
     },
     {
         "domain": "Animation",
         "hidden": true,
         "types": [
             {
+                "id": "AnimationPlayerId",
+                "type": "string",
+                "description": "Unique AnimationPlayer identifier."
+            },
+            {
                 "id": "AnimationPlayer",
                 "type": "object",
                 "hidden": true,
                 "properties": [
-                    { "name": "id", "type": "string", "description": "<code>AnimationPlayer</code>'s id." },
+                    { "name": "id", "$ref": "AnimationPlayerId", "description": "<code>AnimationPlayer</code>'s id." },
                     { "name": "pausedState", "type": "boolean", "hidden": "true", "description": "<code>AnimationPlayer</code>'s internal paused state." },
                     { "name": "playState", "type": "string", "description": "<code>AnimationPlayer</code>'s play state." },
                     { "name": "playbackRate", "type": "number", "description": "<code>AnimationPlayer</code>'s playback rate." },
                     { "name": "startTime", "type": "number", "description": "<code>AnimationPlayer</code>'s start time." },
                     { "name": "currentTime", "type": "number", "description": "<code>AnimationPlayer</code>'s current time." },
                     { "name": "source", "$ref": "AnimationNode", "description": "<code>AnimationPlayer</code>'s source animation node." },
                     { "name": "type", "type": "string", "enum": ["CSSTransition", "CSSAnimation", "WebAnimation"], "description": "Animation type of <code>AnimationPlayer</code>." }
                 ],
                 "description": "AnimationPlayer instance."
             },
@@ skipping 28 matching lines @@
             },
             {
                 "id": "KeyframeStyle",
                 "type": "object",
                 "properties": [
                     { "name": "offset", "type": "string", "description": "Keyframe's time offset." },
                     { "name": "style", "$ref": "CSS.CSSStyle", "description": "Keyframe's associated CSS style declaration." },
                     { "name": "easing", "type": "string", "description": "<code>AnimationNode</code>'s timing function." }
                 ],
                 "description": "Keyframe Style"
+            },
+            {
+                "id": "AnimationStartTime",
+                "type": "object",
+                "properties": [
+                    { "name": "id", "$ref": "AnimationPlayerId", "description": "<code>AnimationPlayer</code>'s id." },
+                    { "name": "startTime", "type": "number", "description": "Updated normalized <code>AnimationPlayer</code>'s start time." }
+                ],
+                "description": "Map from animation id to animation start time"
             }
         ],
         "commands": [
             {
                 "name": "enable",
                 "description": "Enables animation domain notifications."
             },
             {
                 "name": "getAnimationPlayersForNode",
                 "parameters": [
                     { "name": "nodeId", "$ref": "DOM.NodeId", "description": "Id of the node to get animation players for." },
                     { "name": "includeSubtreeAnimations", "type": "boolean", "description": "Include animations from elements subtree." }
                 ],
                 "returns": [
                     { "name": "animationPlayers", "type": "array", "items": { "$ref": "AnimationPlayer" }, "description": "Array of animation players." }
                 ],
                 "description": "Returns animation players relevant to the node.",
                 "hidden": true
             },
             {
                 "name": "getPlaybackRate",
                 "returns": [
                     { "name": "playbackRate", "type": "number", "description": "Playback rate for animations on page."}
                 ],
                 "description": "Gets the playback rate of the document timeline."
             },
             {
                 "name": "setPlaybackRate",
                 "parameters": [
-                    { "name": "playbackRate", "type": "number", "description": "Playback rate for animations on page" }
+                    { "name": "playbackRate", "type": "number", "description": "Playback rate for animations on page." }
+                ],
+                "returns": [
+                    { "name": "animationStartTimes", "type": "array", "items": { "$ref": "AnimationStartTime" }, "description": "List of updated animation start times." }

[pfeldman, 2015/04/07 10:27:34]

I'd like to better understand when animation times update. Can we book some time
to chat about it offline?

                 ],
                 "description": "Sets the playback rate of the document timeline."
             },
             {
-                "name": "setCurrentTime",
+                "name": "seekTimelineTo",
                 "parameters": [
-                    { "name": "currentTime", "type": "number", "description": "Current time for the page animation timeline" }
+                    { "name": "time", "type": "number", "description": "Time to seek animation timelines to." }
+                ],
+                "returns": [
+                    { "name": "animationStartTimes", "type": "array", "items": { "$ref": "AnimationStartTime" }, "description": "List of updated animation start times." }
                 ],
                 "description": "Sets the current time of the document timeline."
             },
             {
+                "name": "seekTimelineBy",
+                "parameters": [
+                    { "name": "timeDelta", "type": "number", "description": "Time delta in milliseconds to seek animation timelines." }
+                ],
+                "description": "Seek animation timelines by a ms time delta."
+            },
+            {
                 "name": "setTiming",
                 "parameters": [
-                    { "name": "playerId", "type": "string", "description": "AnimationPlayer id." },
+                    { "name": "playerId", "$ref": "AnimationPlayerId", "description": "AnimationPlayer id." },
                     { "name": "duration", "type": "number", "description": "Duration of the animation." },
                     { "name": "delay", "type": "number", "description": "Delay of the animation." }
                 ],
                 "description": "Sets the timing of an animation node."
             }
         ],
         "events": [
             {
                 "name": "animationPlayerCreated",
                 "parameters": [
@@ skipping 127 matching lines @@
                 ],
                 "returns": [
                     { "name": "accessibilityNode", "$ref": "AXNode", "description": "The <code>Accessibility.AXNode</code> for this DOM node, if it exists.", "optional": true }
                 ],
                 "description": "Fetches the accessibility node for this DOM node, if it exists.",
                 "hidden": true
             }
         ]
     }]
 }