This is a project that provides an extension to Unity's API to enable recording and playback of runtime calls by serializing and storing them. Playback is achieved by restoring calls based on timestamps. The goal is to support replay functionality for the majority of commonly used APIs that affect visual presentation, with minimal modifications.
- Recording and playback of the complete lifecycle of prefabs from instantiation to destruction.
- Recording of changes to scene objects.
- Start and stop recording at any time.
- When starting recording or playback, any prefabs created will be cleared, and some initial state of scene objects will be restored.
- Playback supports using TimeScale to achieve pause, acceleration, and deceleration effects. However, due to unpredictable animations, precise time skipping is not perfectly supported.
- APIs called frame by frame, such as movement and rotation, support frame reduction compression to optimize storage size. The final files can also be compressed and encrypted.
- Custom method calls can be recorded and played back.
-
Attach the
ReplayableUnitscript to scene objects and prefabs that need to be recorded and played back. This script records references to all components on the object and its child objects. After making modifications to such objects, click "Refresh References" in the Inspector panel. Certain modifications may invalidate previously recorded replays. -
Place the
ReplayableManagerin the scene. -
Add the prefabs and runtime reference instances used by all
ReplayableUnitscripts toReplayableManager/ReferenceManager(script)/references(List). -
Replace Unity API calls with the corresponding replayable APIs listed below.
-
For more details on principles and usage, refer to the example scenes.
Replace the following Unity APIs with their corresponding replayable APIs:
| Unity API | ==> | Replayable API |
|---|---|---|
| (Static)GameObject.Instantiate(ReplayableUnit unit) | ==> | (Static)ReplayableAPI.ReInstantiate(ReplayableUnit unit) |
| (Static)GameObject.Destroy(ReplayableUnit unit) | ==> | (Static)ReplayableAPI.ReDestroy(ReplayableUnit unit) |
| GameObject.SetActive(bool value) | ==> | GameObject.ReActive(bool value) |
| Transform.SetParent(Transform transform) | ==> | Transform.ReParent(Transform transform) |
| (Property)Transform.parent = Transform transform | ==> | Transform.ReParent(Transform transform) |
| (Property)Transform.positon = Vector3 value | ==> | Transform.RePosition(Vector3 value) |
| (Property)Transform.localPositon = Vector3 value | ==> | Transform.ReLoaclPosition(Vector3 value) |
| (Property)Transform.eulerAngles = Vector3 value | ==> | Transform.ReRotation(Vector3 value) |
| (Property)Transform.localeulerAngles = Vector3 value | ==> | Transform.ReLoaclRotation(Vector3 value) |
| (Property)Transform.localScale = Vector3 value | ==> | Transform.ReScale(Vector3 value) |
| Renderer.material.SetFloat(string name, float value) | ==> | Renderer.ReFloat(string name, float value) |
| Renderer.material[index].SetFloat(string name, float value) | ==> | Renderer.ReFloat(string name, float value, int index) |
| Renderer.material.SetColor(string name, Color value) | ==> | Renderer.ReColor(string name, Color value) |
| Renderer.material[index].SetColor(string name, Color value) | ==> | Renderer.ReColor(string name, Color value, int index) |
| Renderer.material.SetVector(string name, Vector4 value) | ==> | Renderer.ReVector(string name, Vector4 value) |
| Renderer.material[index].SetVector(string name, Vector4 value) | ==> | Renderer.ReVector(string name, Vector4 value, int index) |
| Renderer.material.SetTexture(string name, Texture value) | ==> | ~~Renderer.ReTexture(string name, Texture value) |
| Renderer.material[index].SetTexture(string name, Texture value) | ==> | ~~Renderer.ReTexture(string name, Texture value, int index) |
| Animator.SetInteger(int id, int value) | ==> | Animator.ReInteger(int id, int value) |
| Animator.SetInteger(string name, int value) | ==> | Animator.ReInteger(string name, int value) |
| Animator.SetFloat(int id, float value) | ==> | Animator.ReFloat(int id, float value) |
| Animator.SetFloat(string name, float value) | ==> | Animator.ReFloat(string name, float value) |
| Animator.SetBool(int id, bool value) | ==> | Animator.ReBool(int id, bool value) |
| Animator.SetBool(string name, bool value) | ==> | Animator.ReBool(string name, bool value) |
| Animator.SetTrigger(int id) | ==> | Animator.ReTrigger(int id) |
| Animator.SetTrigger(string name) | ==> | Animator.ReTrigger(string name) |
| Animator.ReSetTrigger(int id) | ==> | Animator.ReReSetTrigger(int id) |
| Animator.ReSetTrigger(string name) | ==> | Animator.ReReSetTrigger(string name) |
| Animator.Play(string stateName, int layer = -1, float normalizedTime = float.NegativeInfinity) | ==> | Animator.RePlay(string stateName, int layer = -1, float normalizedTime = float.NegativeInfinity) |
| (Property)Animator.speed = float value | ==> | Animator.ReSpeed(float value) |
| Animation.Play(string animation = null, PlayMode mode = PlayMode.StopSameLayer) | ==> | Animation.RePlay(string animation = null, PlayMode mode = PlayMode.StopSameLayer) |
| Animation.Stop(string animation = null) | ==> | Animation.ReStop(string animation = null) |
| Animation.Rewind(string animation = null) | ==> | Animation.ReRewind(string animation = null) |