Method get_file

astrbot/core/message/components.py:824–853

异步获取文件。请注意在使用后清理下载的文件, 以免占用过多空间 Args: allow_return_url: 是否允许以文件 http 下载链接的形式返回，这允许您自行控制是否需要下载文件。 注意，如果为 True，也可能返回文件路径。 Returns: str: 文件路径或者 http 下载链接

(self, allow_return_url: bool = False)

            self.file_ = value

    async def get_file(self, allow_return_url: bool = False) -> str:
        """异步获取文件。请注意在使用后清理下载的文件, 以免占用过多空间

        Args:
            allow_return_url: 是否允许以文件 http 下载链接的形式返回，这允许您自行控制是否需要下载文件。
            注意，如果为 True，也可能返回文件路径。
        Returns:
            str: 文件路径或者 http 下载链接

        """
        if allow_return_url and self.url:
            return self.url

        if self.file_:
            path = self.file_
            if is_file_uri(path):
                path = file_uri_to_path(path)

            if os.path.exists(path):
                return os.path.abspath(path)

        if self.url:
            await self._download_file()
            if self.file_:
                path = self.file_
                if is_file_uri(path):
                    path = file_uri_to_path(path)
                return os.path.abspath(path)

        return ""

    async def _download_file(self) -> None:
        """下载文件"""