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 4800 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." },

[pfeldman, 2015/04/03 09:19:41]

Is this monotonicallyIncreasing time?

[samli, 2015/04/03 09:56:00]

Yes.

                     { "name": "currentTime", "type": "number", "description": "<code>AnimationPlayer</code>'s current time." },

[pfeldman, 2015/04/03 09:19:41]

Is this monotonicallyIncreasing time?

[samli, 2015/04/03 09:56:00]

This is always relative to the player. It's start time + current time

[pfeldman, 2015/04/03 10:36:49]

Lets rename it to currentOffset?

[samli, 2015/04/03 11:31:32]

No, this matches the Web Animations spec.
https://w3c.github.io/web-animations/

                     { "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."
             },
             {
                 "id": "AnimationNode",
                 "type": "object",
                 "hidden": true,
                 "properties": [
@@ skipping 23 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." }

[pfeldman, 2015/04/03 09:19:41]

Is this monotonicallyIncreasing time?

[samli, 2015/04/03 09:56:00]

Yes.

[pfeldman, 2015/04/03 10:36:49]

Why is it called normalized then?

[samli, 2015/04/03 11:31:32]

Normalise means to "bring to a standard". We convert relative timeline times to
a standard interface of time. I think it's a reasonable name.

+                ],
+                "description": "Map from animation id to animation start time"
             }
         ],
         "commands": [
             {
                 "name": "enable",
                 "description": "Enables animation domain notifications."
             },
             {
                 "name": "getAnimationPlayersForNode",
                 "parameters": [
@@ skipping 11 matching lines @@
                 "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" }
                 ],
+                "returns": [
+                    { "name": "animationStartTimes", "type": "array", "items": { "$ref": "AnimationStartTime" }, "description": "List of updated animation start times." }

[pfeldman, 2015/04/03 10:36:49]

So why do you want to collect all start times upon setPlaybackRate and
setCurrentTimes? When does the start time of the animation player change?

[samli, 2015/04/03 11:31:32]

Conceptual start time is always relative to timeline time. When we manipulate
playback rate of a timeline the current time of the timeline does not change.
Old monotonic values are invalidated since they cannot be converted back to
timeline times since the timeline 'scaled' relative to monotonic time.

When seeking a timeline, we are effectively shifting the timeline relative to
monotonic time. This invalidates the start times we sent earlier.

In both cases, the original monotonic start times no longer reference the right
time in the timelines so we need to update the start times.

+                ],
                 "description": "Sets the playback rate of the document timeline."
             },
             {
                 "name": "setCurrentTime",
                 "parameters": [
-                    { "name": "currentTime", "type": "number", "description": "Current time for the page animation timeline" }
+                    { "name": "normalizedCurrentTime", "type": "number", "description": "Current time for the page animation timeline" }

[pfeldman, 2015/04/03 09:19:41]

Is this monotonicallyIncreasing time?

[samli, 2015/04/03 09:56:00]

Yes

+                ],
+                "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": "seekTimeline",
+                "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
             }
         ]
     }]
 }