Method __init__

source/binding/Python/maa/controller.py:1102–1125

创建回放控制器 / Create replay controller Args: recording_path: 录制 JSONL 文件路径，由 RecordController 写入。截图路径基于该文件所在目录解析。 Path to the recording JSONL file written by RecordController. Screenshot paths are resolved relative to this fil

(
        self,
        recording_path: Union[str, Path],
    )

    """回放控制器，用于回放录制文件 / Replay controller for replaying recorded operations"""

    def __init__(
        self,
        recording_path: Union[str, Path],
    ):
        """创建回放控制器 / Create replay controller

        Args:
            recording_path: 录制 JSONL 文件路径，由 RecordController 写入。截图路径基于该文件所在目录解析。

                            Path to the recording JSONL file written by RecordController. Screenshot
                            paths are resolved relative to this file's parent directory.

        Raises:
            RuntimeError: 如果创建失败
        """
        super().__init__()
        self._set_replay_api_properties()

        self._handle = Library.framework().MaaReplayControllerCreate(
            str(recording_path).encode(),
        )

        if not self._handle:
            raise RuntimeError("Failed to create replay controller.")

    def _set_replay_api_properties(self):
        Library.framework().MaaReplayControllerCreate.restype = MaaControllerHandle