InteractionTracker.TryUpdatePositionWithAnimation 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
嘗試套用動畫來更新 InteractionTracker的位置。
TryUpdatePositionWithAnimation 方法會根據CompositionAnimation輸入做為參數來更新InteractionTracker的位置。 這個方法用於 互動Tracker 的動作需要由特定動畫定義,而不是傳統的慣性體驗。 TryUpdatePositionWithAnimation 可以從 Idle 或 Inertia 狀態呼叫 ,如此一來, InteractionTracker 的位置將會由定義的動畫驅動,並進入 CustomAnimation 狀態。
public:
virtual int TryUpdatePositionWithAnimation(CompositionAnimation ^ animation) = TryUpdatePositionWithAnimation;
int TryUpdatePositionWithAnimation(CompositionAnimation const& animation);
public int TryUpdatePositionWithAnimation(CompositionAnimation animation);
function tryUpdatePositionWithAnimation(animation)
Public Function TryUpdatePositionWithAnimation (animation As CompositionAnimation) As Integer
參數
- animation
- CompositionAnimation
要套用至 InteractionTracker的動畫。
傳回
Int32
int
傳回要求識別碼。 在狀態轉換時,造成狀態變更的要求將會包含在引數中。 這些識別碼會從 1 開始,並在應用程式存留期期間,隨著每次嘗試呼叫而增加。
範例
void CustomAnimationForIT(Vector3 newPosition)
{
// Create a cubic bezier easing function that will be used in the KeyFrames
CompositionEasingFunction cubicBezier = _compositor.CreateCubicBezierEasingFunction(new Vector2(.17f, .67f), new Vector2(1f, 1f);
// Create the Vector3 KFA
Vector3KeyFrameAnimation kfa = _compositor.CreateVector3KeyFrameAnimation();
kfa.Duration = TimeSpan.FromSeconds(3);
// Create the KeyFrames
kfa.InsertKeyFrame(1.0f, newPosition, cubicBezier);
// Update InteractionTracker position using this animation
_tracker.TryUpdatePositionWithAnimation(kfa);
}
備註
建立您想要更新 InteractionTracker 位置的動畫時,您不需要呼叫 StartAnimation。 一旦透過 TryUpdatePositionWithAnimation 傳入動畫,系統就會在幕後處理此動作。
定義動畫以動畫顯示 InteractionTracker 的位置時,請務必使用 Vector3KeyFrameAnimation 或解析為 Vector3 的 ExpressionAnimation 。
下表摘要說明以特定狀態呼叫此方法時的預期行為:
目前狀態 | 成果 |
---|---|
閒置 | 要求的動畫會從要求的屬性開始,狀態變更為 CustomAnimation |
Interacting | 要求已忽略 |
慣性 | 要求的動畫會從要求的屬性開始,狀態變更為 CustomAnimation |
CustomAnimation | 目前的動畫會停止,而新的要求動畫會在要求的屬性上啟動,狀態會重新進入 CustomAnimation |