瀏覽代碼

Add note about unique object names to KeyframeTrack.html (#31373)

Florian Kaiser 11 月之前
父節點
當前提交
059965e5fa
共有 1 個文件被更改,包括 7 次插入4 次删除
  1. 7 4
      docs/api/en/animation/KeyframeTrack.html

+ 7 - 4
docs/api/en/animation/KeyframeTrack.html

@@ -126,10 +126,13 @@
 		</p>
 
 		<p>
-			Note: The track's name does not necessarily have to be unique. Multiple
-			tracks can drive the same property. The result should be based on a
-			weighted blend between the multiple tracks according to the weights of
-			their respective actions.
+			Note: The track’s name does not necessarily have to be unique. Multiple tracks
+			can drive the same property, resulting in a weighted blend between the tracks 
+			according to the weights of their respective actions. However, if object names
+			used for targeting are not unique within the subtree, tracks referencing
+			those objects by name will only animate the first object encountered, even if
+			the path is unique. To reliably target distinct objects use UUIDs, or ensure
+			object names remain unique.
 		</p>
 
 		<h3>[property:Float32Array times]</h3>

粤ICP备19079148号