pycapcut 0.0.1__py3-none-any.whl

pycapcut/keyframe.py

@@ -0,0 +1,94 @@
+import uuid
+
+from enum import Enum
+from typing import Dict, List, Any
+
+class Keyframe:
+    """一个关键帧（关键点）, 目前只支持线性插值"""
+
+    kf_id: str
+    """关键帧全局id, 自动生成"""
+    time_offset: int
+    """相对于素材起始点的时间偏移量"""
+    values: List[float]
+    """关键帧的值, 似乎一般只有一个元素"""
+
+    def __init__(self, time_offset: int, value: float):
+        """给定时间偏移量及关键值, 初始化关键帧"""
+        self.kf_id = uuid.uuid4().hex
+
+        self.time_offset = time_offset
+        self.values = [value]
+
+    def export_json(self) -> Dict[str, Any]:
+        return {
+            # 默认值
+            "curveType": "Line",
+            "graphID": "",
+            "left_control": {"x": 0.0, "y": 0.0},
+            "right_control": {"x": 0.0, "y": 0.0},
+            # 自定义属性
+            "id": self.kf_id,
+            "time_offset": self.time_offset,
+            "values": self.values
+        }
+
+class KeyframeProperty(Enum):
+    """关键帧所控制的属性类型"""
+
+    position_x = "KFTypePositionX"
+    """右移为正, 此处的数值应该为`剪映中显示的值` / `草稿宽度`, 也即单位是半个画布宽"""
+    position_y = "KFTypePositionY"
+    """上移为正, 此处的数值应该为`剪映中显示的值` / `草稿高度`, 也即单位是半个画布高"""
+    rotation = "KFTypeRotation"
+    """顺时针旋转的**角度**"""
+
+    scale_x = "KFTypeScaleX"
+    """单独控制X轴缩放比例(1.0为不缩放), 与`uniform_scale`互斥"""
+    scale_y = "KFTypeScaleY"
+    """单独控制Y轴缩放比例(1.0为不缩放), 与`uniform_scale`互斥"""
+    uniform_scale = "UNIFORM_SCALE"
+    """同时控制X轴及Y轴缩放比例(1.0为不缩放), 与`scale_x`和`scale_y`互斥"""
+
+    alpha = "KFTypeAlpha"
+    """不透明度, 1.0为完全不透明, 仅对`VideoSegment`有效"""
+    saturation = "KFTypeSaturation"
+    """饱和度, 0.0为原始饱和度, 范围为-1.0到1.0, 仅对`VideoSegment`有效"""
+    contrast = "KFTypeContrast"
+    """对比度, 0.0为原始对比度, 范围为-1.0到1.0, 仅对`VideoSegment`有效"""
+    brightness = "KFTypeBrightness"
+    """亮度, 0.0为原始亮度, 范围为-1.0到1.0, 仅对`VideoSegment`有效"""
+
+    volume = "KFTypeVolume"
+    """音量, 1.0为原始音量, 仅对`AudioSegment`和`VideoSegment`有效"""
+
+class KeyframeList:
+    """关键帧列表, 记录与某个特定属性相关的一系列关键帧"""
+
+    list_id: str
+    """关键帧列表全局id, 自动生成"""
+    keyframe_property: KeyframeProperty
+    """关键帧对应的属性"""
+    keyframes: List[Keyframe]
+    """关键帧列表"""
+
+    def __init__(self, keyframe_property: KeyframeProperty):
+        """为给定的关键帧属性初始化关键帧列表"""
+        self.list_id = uuid.uuid4().hex
+
+        self.keyframe_property = keyframe_property
+        self.keyframes = []
+
+    def add_keyframe(self, time_offset: int, value: float):
+        """给定时间偏移量及关键值, 向此关键帧列表中添加一个关键帧"""
+        keyframe = Keyframe(time_offset, value)
+        self.keyframes.append(keyframe)
+        self.keyframes.sort(key=lambda x: x.time_offset)
+
+    def export_json(self) -> Dict[str, Any]:
+        return {
+            "id": self.list_id,
+            "keyframe_list": [kf.export_json() for kf in self.keyframes],
+            "material_id": "",
+            "property_type": self.keyframe_property.value
+        }

pycapcut/local_materials.py

@@ -0,0 +1,198 @@
+import os
+import uuid
+import pymediainfo
+
+from typing import Optional, Literal
+from typing import Dict, Any
+
+class CropSettings:
+    """素材的裁剪设置, 各属性均在0-1之间, 注意素材的坐标原点在左上角"""
+
+    upper_left_x: float
+    upper_left_y: float
+    upper_right_x: float
+    upper_right_y: float
+    lower_left_x: float
+    lower_left_y: float
+    lower_right_x: float
+    lower_right_y: float
+
+    def __init__(self, *, upper_left_x: float = 0.0, upper_left_y: float = 0.0,
+                 upper_right_x: float = 1.0, upper_right_y: float = 0.0,
+                 lower_left_x: float = 0.0, lower_left_y: float = 1.0,
+                 lower_right_x: float = 1.0, lower_right_y: float = 1.0):
+        """初始化裁剪设置, 默认参数表示不裁剪"""
+        self.upper_left_x = upper_left_x
+        self.upper_left_y = upper_left_y
+        self.upper_right_x = upper_right_x
+        self.upper_right_y = upper_right_y
+        self.lower_left_x = lower_left_x
+        self.lower_left_y = lower_left_y
+        self.lower_right_x = lower_right_x
+        self.lower_right_y = lower_right_y
+
+    def export_json(self) -> Dict[str, Any]:
+        return {
+            "upper_left_x": self.upper_left_x,
+            "upper_left_y": self.upper_left_y,
+            "upper_right_x": self.upper_right_x,
+            "upper_right_y": self.upper_right_y,
+            "lower_left_x": self.lower_left_x,
+            "lower_left_y": self.lower_left_y,
+            "lower_right_x": self.lower_right_x,
+            "lower_right_y": self.lower_right_y
+        }
+
+class VideoMaterial:
+    """本地视频素材（视频或图片）, 一份素材可以在多个片段中使用"""
+
+    material_id: str
+    """素材全局id, 自动生成"""
+    local_material_id: str
+    """素材本地id, 意义暂不明确"""
+    material_name: str
+    """素材名称"""
+    path: str
+    """素材文件路径"""
+    duration: int
+    """素材时长, 单位为微秒"""
+    height: int
+    """素材高度"""
+    width: int
+    """素材宽度"""
+    crop_settings: CropSettings
+    """素材裁剪设置"""
+    material_type: Literal["video", "photo"]
+    """素材类型: 视频或图片"""
+
+    def __init__(self, path: str, material_name: Optional[str] = None, crop_settings: CropSettings = CropSettings()):
+        """从指定位置加载视频（或图片）素材
+
+        Args:
+            path (`str`): 素材文件路径, 支持mp4, mov, avi等常见视频文件及jpg, jpeg, png等图片文件.
+            material_name (`str`, optional): 素材名称, 如果不指定, 默认使用文件名作为素材名称.
+            crop_settings (`CropSettings`, optional): 素材裁剪设置, 默认不裁剪.
+
+        Raises:
+            `FileNotFoundError`: 素材文件不存在.
+            `ValueError`: 不支持的素材文件类型.
+        """
+        path = os.path.abspath(path)
+        postfix = os.path.splitext(path)[1]
+        if not os.path.exists(path):
+            raise FileNotFoundError(f"找不到 {path}")
+
+        self.material_name = material_name if material_name else os.path.basename(path)
+        self.material_id = uuid.uuid3(uuid.NAMESPACE_DNS, self.material_name).hex
+        self.path = path
+        self.crop_settings = crop_settings
+        self.local_material_id = ""
+
+        if not pymediainfo.MediaInfo.can_parse():
+            raise ValueError(f"不支持的视频素材类型 '{postfix}'")
+
+        info: pymediainfo.MediaInfo = \
+            pymediainfo.MediaInfo.parse(path, mediainfo_options={"File_TestContinuousFileNames": "0"})  # type: ignore
+        # 有视频轨道的视为视频素材
+        if len(info.video_tracks):
+            self.material_type = "video"
+            self.duration = int(info.video_tracks[0].duration * 1e3)  # type: ignore
+            self.width, self.height = info.video_tracks[0].width, info.video_tracks[0].height  # type: ignore
+        # gif文件使用imageio库获取长度
+        elif postfix.lower() == ".gif":
+            import imageio
+            gif = imageio.get_reader(path)
+
+            self.material_type = "video"
+            self.duration = int(round(gif.get_meta_data()['duration'] * gif.get_length() * 1e3))
+            self.width, self.height = info.image_tracks[0].width, info.image_tracks[0].height  # type: ignore
+            gif.close()
+        elif len(info.image_tracks):
+            self.material_type = "photo"
+            self.duration = 10800000000  # 相当于3h
+            self.width, self.height = info.image_tracks[0].width, info.image_tracks[0].height  # type: ignore
+        else:
+            raise ValueError(f"输入的素材文件 {path} 没有视频轨道或图片轨道")
+
+    def export_json(self) -> Dict[str, Any]:
+        video_material_json = {
+            "audio_fade": None,
+            "category_id": "",
+            "category_name": "local",
+            "check_flag": 63487,
+            "crop": self.crop_settings.export_json(),
+            "crop_ratio": "free",
+            "crop_scale": 1.0,
+            "duration": self.duration,
+            "height": self.height,
+            "id": self.material_id,
+            "local_material_id": self.local_material_id,
+            "material_id": self.material_id,
+            "material_name": self.material_name,
+            "media_path": "",
+            "path": self.path,
+            "type": self.material_type,
+            "width": self.width
+        }
+        return video_material_json
+
+class AudioMaterial:
+    """本地音频素材"""
+
+    material_id: str
+    """素材全局id, 自动生成"""
+    material_name: str
+    """素材名称"""
+    path: str
+    """素材文件路径"""
+
+    duration: int
+    """素材时长, 单位为微秒"""
+
+    def __init__(self, path: str, material_name: Optional[str] = None):
+        """从指定位置加载音频素材, 注意视频文件不应该作为音频素材使用
+
+        Args:
+            path (`str`): 素材文件路径, 支持mp3, wav等常见音频文件.
+            material_name (`str`, optional): 素材名称, 如果不指定, 默认使用文件名作为素材名称.
+
+        Raises:
+            `FileNotFoundError`: 素材文件不存在.
+            `ValueError`: 不支持的素材文件类型.
+        """
+        path = os.path.abspath(path)
+        if not os.path.exists(path):
+            raise FileNotFoundError(f"找不到 {path}")
+
+        self.material_name = material_name if material_name else os.path.basename(path)
+        self.material_id = uuid.uuid3(uuid.NAMESPACE_DNS, self.material_name).hex
+        self.path = path
+
+        if not pymediainfo.MediaInfo.can_parse():
+            raise ValueError("不支持的音频素材类型 %s" % os.path.splitext(path)[1])
+        info: pymediainfo.MediaInfo = pymediainfo.MediaInfo.parse(path)  # type: ignore
+        if len(info.video_tracks):
+            raise ValueError("音频素材不应包含视频轨道")
+        if not len(info.audio_tracks):
+            raise ValueError(f"给定的素材文件 {path} 没有音频轨道")
+        self.duration = int(info.audio_tracks[0].duration * 1e3)  # type: ignore
+
+    def export_json(self) -> Dict[str, Any]:
+        return {
+            "app_id": 0,
+            "category_id": "",
+            "category_name": "local",
+            "check_flag": 3,
+            "copyright_limit_type": "none",
+            "duration": self.duration,
+            "effect_id": "",
+            "formula_id": "",
+            "id": self.material_id,
+            "local_material_id": self.material_id,
+            "music_id": self.material_id,
+            "name": self.material_name,
+            "path": self.path,
+            "source_platform": 0,
+            "type": "extract_music",
+            "wave_points": []
+        }

pycapcut/metadata/__init__.py

@@ -0,0 +1,51 @@
+"""记录各种特效/音效/滤镜等的元数据"""
+
+from .effect_meta import EffectMeta, EffectParamInstance
+from .effect_meta import AnimationMeta
+
+# 视频特效
+from .video_scene_effect import VideoSceneEffectType
+from .video_character_effect import VideoCharacterEffectType
+
+# 视频动画
+from .video_intro import IntroType
+from .video_outro import OutroType
+from .video_group_animation import GroupAnimationType
+
+# 音频特效
+from .audio_scene_effect import AudioSceneEffectType
+from .tone_effect import ToneEffectType
+from .speech_to_song import SpeechToSongType
+
+# 文本动画
+from .text_intro import TextIntro
+from .text_outro import TextOutro
+from .text_loop import TextLoopAnim
+
+# 其它
+from .font_meta import FontType
+from .mask_meta import MaskType, MaskMeta
+from .filter_meta import FilterType
+from .transition_meta import TransitionType
+
+__all__ = [
+    "AnimationMeta",
+    "EffectMeta",
+    "EffectParamInstance",
+    "MaskType",
+    "MaskMeta",
+    "FilterType",
+    "FontType",
+    "TransitionType",
+    "IntroType",
+    "OutroType",
+    "GroupAnimationType",
+    "TextIntro",
+    "TextOutro",
+    "TextLoopAnim",
+    "AudioSceneEffectType",
+    "ToneEffectType",
+    "SpeechToSongType",
+    "VideoSceneEffectType",
+    "VideoCharacterEffectType"
+]

pycapcut/metadata/audio_scene_effect.py

@@ -0,0 +1,252 @@
+from .effect_meta import EffectEnum
+from .effect_meta import EffectMeta, EffectParam
+
+class AudioSceneEffectType(EffectEnum):
+    """剪映自带的音频“场景音”效果类型"""
+
+    # 免费
+    _8bit       = EffectMeta("8bit", False, "7161319747584266766", "5723961", "8d24238329ea5c250e33ae241d5adae2", [
+                                    EffectParam("change_voice_param_pitch_shift", 0.500, 0.000, 1.000),
+                                    EffectParam("change_voice_param_timbre", 1.000, 0.000, 1.000),
+                                    EffectParam("change_voice_param_strength", 1.000, 0.000, 1.000)])
+    """参数:
+        - change_voice_param_pitch_shift: 默认0.50, 0.00 ~ 1.00
+        - change_voice_param_timbre: 默认1.00, 0.00 ~ 1.00
+        - change_voice_param_strength: 默认1.00, 0.00 ~ 1.00
+    """
+    低保真      = EffectMeta("低保真", False, "7024390914537689614", "2672762", "7ddbd39a691a66a021f684cab756a89a", [
+                                    EffectParam("强弱", 1.000, 0.000, 1.000)])
+    """参数:
+        - 强弱: 默认1.00, 0.00 ~ 1.00
+    """
+    合成器      = EffectMeta("合成器", False, "7018011500577034759", "2672753", "394efea5922637bcd8288e0fb3c2372e", [
+                                    EffectParam("强弱", 1.000, 0.000, 1.000)])
+    """参数:
+        - 强弱: 默认1.00, 0.00 ~ 1.00
+    """
+    回音        = EffectMeta("回音", False, "7018011608408396325", "5723901", "5377f66109693f2d473df5ea6ec8f791", [
+                                    EffectParam("change_voice_param_quantity", 0.800, 0.000, 1.000),
+                                    EffectParam("change_voice_param_strength", 0.762, 0.000, 1.000)])
+    """参数:
+        - change_voice_param_quantity: 默认0.80, 0.00 ~ 1.00
+        - change_voice_param_strength: 默认0.76, 0.00 ~ 1.00
+    """
+    扩音器      = EffectMeta("扩音器", False, "7018011975514853924", "2672749", "13169f6ab9957ff005d316239bef0045", [
+                                    EffectParam("强弱", 1.000, 0.000, 1.000)])
+    """参数:
+        - 强弱: 默认1.00, 0.00 ~ 1.00
+    """
+    水下        = EffectMeta("水下", False, "7106404450444513806", "2673077", "53956694a8b68b2855faa2adc043b5b1", [
+                                    EffectParam("深度", 0.500, 0.000, 1.000)])
+    """参数:
+        - 深度: 默认0.50, 0.00 ~ 1.00
+    """
+    没电了      = EffectMeta("没电了", False, "7018012193769656845", "2672747", "87f91614bac060840ad5a57ef2b0c9ca", [
+                                    EffectParam("强弱", 1.000, 0.000, 1.000)])
+    """参数:
+        - 强弱: 默认1.00, 0.00 ~ 1.00
+    """
+    环绕音      = EffectMeta("环绕音", False, "7161319847819743780", "5723960", "fa9a4cb20d3488bf79e176571d5841f5", [
+                                    EffectParam("change_voice_param_center_position", 0.500, 0.000, 1.000),
+                                    EffectParam("change_voice_param_surrounding_frequency", 0.500, 0.000, 1.000)])
+    """参数:
+        - change_voice_param_center_position: 默认0.50, 0.00 ~ 1.00
+        - change_voice_param_surrounding_frequency: 默认0.50, 0.00 ~ 1.00
+    """
+    电音        = EffectMeta("电音", False, "7018011438379700773", "2672754", "d893a319d5175d9f09f70ddef1f79980", [
+                                    EffectParam("强弱", 1.000, 0.000, 1.000)])
+    """参数:
+        - 强弱: 默认1.00, 0.00 ~ 1.00
+    """
+    颤音        = EffectMeta("颤音", False, "7018011370289369637", "2672755", "c5e4874f83337e1cb9f8322fb843c901", [
+                                    EffectParam("频率", 0.714, 0.000, 1.000),
+                                    EffectParam("幅度", 0.905, 0.000, 1.000)])
+    """参数:
+        - 频率: 默认0.71, 0.00 ~ 1.00
+        - 幅度: 默认0.91, 0.00 ~ 1.00
+    """
+    麦霸        = EffectMeta("麦霸", False, "7018012141332468260", "2672748", "3eedef5ef82b32912203a1f4fb901182", [
+                                    EffectParam("空间大小", 0.052, 0.000, 1.000),
+                                    EffectParam("强弱", 0.450, 0.000, 1.000)])
+    """参数:
+        - 空间大小: 默认0.05, 0.00 ~ 1.00
+        - 强弱: 默认0.45, 0.00 ~ 1.00
+    """
+    黑胶        = EffectMeta("黑胶", False, "7024391411764040205", "2672761", "59e61d687a0f612bfae43bccf770f090", [
+                                    EffectParam("强弱", 1.000, 0.000, 1.000),
+                                    EffectParam("噪点", 0.743, 0.000, 1.000)])
+    """参数:
+        - 强弱: 默认1.00, 0.00 ~ 1.00
+        - 噪点: 默认0.74, 0.00 ~ 1.00
+    """
+
+    # 付费
+    _3d环绕音   = EffectMeta("3d环绕音", True, "7350214888242811455", "53187169", "577c3d8e5312012b1d98ba5fc0b206d0", [
+                                    EffectParam("强度", 0.000, 0.000, 1.000)])
+    """参数:
+        - 强度: 默认0.00, 0.00 ~ 1.00
+    """
+    Autotune    = EffectMeta("Autotune", True, "7360900806851170828", "58979352", "1477f4ca8307e2fa4ee2243d98d8b837", [
+                                    EffectParam("强度", 1.000, 0.000, 1.000)])
+    """参数:
+        - 强度: 默认1.00, 0.00 ~ 1.00
+    """
+    下雨        = EffectMeta("下雨", True, "7375069649446113804", "68076030", "83bb223637d5368384c47e3d2b061b62", [
+                                    EffectParam("strength", 1.000, 0.000, 1.000),
+                                    EffectParam("noise", 0.743, 0.000, 1.000)])
+    """参数:
+        - strength: 默认1.00, 0.00 ~ 1.00
+        - noise: 默认0.74, 0.00 ~ 1.00
+    """
+    乡村大喇叭  = EffectMeta("乡村大喇叭", True, "7282691036197950009", "23897651", "c996243ac50d235f00e5931e5ecadc52", [
+                                    EffectParam("强度", 1.000, 0.000, 1.000)])
+    """参数:
+        - 强度: 默认1.00, 0.00 ~ 1.00
+    """
+    人声增强    = EffectMeta("人声增强", True, "7106404399756349983", "2673078", "626f988dbd2cbd17acaa24d08451e314", [
+                                    EffectParam("强弱", 1.000, 0.000, 1.000)])
+    """参数:
+        - 强弱: 默认1.00, 0.00 ~ 1.00
+    """
+    低音增强    = EffectMeta("低音增强", True, "7106404304247853604", "2673080", "e7c09c96d10c163269fc4e35c1f4b1ee", [
+                                    EffectParam("change_voice_param_strength", 1.000, 0.000, 1.000)])
+    """参数:
+        - change_voice_param_strength: 默认1.00, 0.00 ~ 1.00
+    """
+    停车场      = EffectMeta("停车场", True, "7372150242524795446", "66413024", "d2dd515293081a8573485159db5a71e0", [
+                                    EffectParam("strength", 1.000, 0.000, 1.000)])
+    """参数:
+        - strength: 默认1.00, 0.00 ~ 1.00
+    """
+    冰川之下    = EffectMeta("冰川之下", True, "7375068986829967883", "68076029", "6b9cda93f6d75b9a3b19b2e8eb6ad40f", [
+                                    EffectParam("strength", 1.000, 0.000, 1.000),
+                                    EffectParam("noise", 0.743, 0.000, 1.000)])
+    """参数:
+        - strength: 默认1.00, 0.00 ~ 1.00
+        - noise: 默认0.74, 0.00 ~ 1.00
+    """
+    刮风        = EffectMeta("刮风", True, "7375069247275274771", "68076028", "8600891882159f364d8c53e4f703cff4", [
+                                    EffectParam("strength", 1.000, 0.000, 1.000),
+                                    EffectParam("noise", 0.743, 0.000, 1.000)])
+    """参数:
+        - strength: 默认1.00, 0.00 ~ 1.00
+        - noise: 默认0.74, 0.00 ~ 1.00
+    """
+    噪音混响    = EffectMeta("噪音混响", True, "7382844688987853349", "72110975", "3b3b09b530b0a64666f1c5b6d20d4018", [
+                                    EffectParam("strength", 1.000, 0.000, 1.000)])
+    """参数:
+        - strength: 默认1.00, 0.00 ~ 1.00
+    """
+    地狱        = EffectMeta("地狱", True, "7375069113988682281", "68076027", "5ec03c41ada16530949daa4106c85a90", [
+                                    EffectParam("strength", 1.000, 0.000, 1.000),
+                                    EffectParam("noise", 0.743, 0.000, 1.000)])
+    """参数:
+        - strength: 默认1.00, 0.00 ~ 1.00
+        - noise: 默认0.74, 0.00 ~ 1.00
+    """
+    复古收音机  = EffectMeta("复古收音机", True, "7350215379714576907", "53187166", "301d642d131aabff7ea8c3b717b36a79", [
+                                    EffectParam("强度", 1.000, 0.000, 1.000)])
+    """参数:
+        - 强度: 默认1.00, 0.00 ~ 1.00
+    """
+    失真电子    = EffectMeta("失真电子", True, "7350215296801575443", "53187167", "a1c00df42076ed1bd6a81f2d30b94566", [
+                                    EffectParam("强度", 1.000, 0.000, 1.000)])
+    """参数:
+        - 强度: 默认1.00, 0.00 ~ 1.00
+    """
+    对讲机      = EffectMeta("对讲机", True, "7350214704284832275", "53187168", "016dbdb3c786896c92bb936ece11acf6", [
+                                    EffectParam("强度", 1.000, 0.000, 1.000)])
+    """参数:
+        - 强度: 默认1.00, 0.00 ~ 1.00
+    """
+    房间        = EffectMeta("房间", True, "7282691385872880165", "23880629", "639f5c0c6b20418aaeb0e144da21151c", [
+                                    EffectParam("强度", 1.000, 0.000, 1.000)])
+    """参数:
+        - 强度: 默认1.00, 0.00 ~ 1.00
+    """
+    捂嘴        = EffectMeta("捂嘴", True, "7372405649684042292", "66552320", "9f9a8270c0005a480547d6ddf2a9293a", [
+                                    EffectParam("strength", 1.000, 0.000, 1.000)])
+    """参数:
+        - strength: 默认1.00, 0.00 ~ 1.00
+    """
+    教堂        = EffectMeta("教堂", True, "7282691146759803429", "23882063", "96dc71756d0025e96a504b42d988b2ac", [
+                                    EffectParam("强度", 1.000, 0.000, 1.000)])
+    """参数:
+        - 强度: 默认1.00, 0.00 ~ 1.00
+    """
+    教室        = EffectMeta("教室", True, "7282687783833965113", "23897703", "678c14a6f63f75e03daa062a254081f7", [
+                                    EffectParam("强度", 1.000, 0.000, 1.000)])
+    """参数:
+        - 强度: 默认1.00, 0.00 ~ 1.00
+    """
+    机器人2     = EffectMeta("机器人2", True, "7372150541738054156", "66413023", "952f3feddf3555939adbbfd1c1869474", [
+                                    EffectParam("strength", 1.000, 0.000, 1.000)])
+    """参数:
+        - strength: 默认1.00, 0.00 ~ 1.00
+    """
+    沙漠        = EffectMeta("沙漠", True, "7375069515530375691", "68076025", "099c935428943c9c3662b15b35b1ee36", [
+                                    EffectParam("strength", 1.000, 0.000, 1.000),
+                                    EffectParam("noise", 0.743, 0.000, 1.000)])
+    """参数:
+        - strength: 默认1.00, 0.00 ~ 1.00
+        - noise: 默认0.74, 0.00 ~ 1.00
+    """
+    派对        = EffectMeta("派对", True, "7381685442795541042", "71718513", "723386ab87f938779a3369436234d903", [
+                                    EffectParam("strength", 1.000, 0.000, 1.000),
+                                    EffectParam("noise", 0.743, 0.000, 1.000)])
+    """参数:
+        - strength: 默认1.00, 0.00 ~ 1.00
+        - noise: 默认0.74, 0.00 ~ 1.00
+    """
+    深海回声    = EffectMeta("深海回声", True, "7350215168413929995", "53187172", "37a16a2dc77540b7d70fe301e482d4f2", [
+                                    EffectParam("强度", 1.000, 0.000, 1.000)])
+    """参数:
+        - 强度: 默认1.00, 0.00 ~ 1.00
+    """
+    电话        = EffectMeta("电话", True, "7264894634285863483", "20255003", "5da5a98b8c926c0dcc1c3c8bc3f3012f", [
+                                    EffectParam("强弱", 0.700, 0.000, 1.000)])
+    """参数:
+        - 强弱: 默认0.70, 0.00 ~ 1.00
+    """
+    留声机      = EffectMeta("留声机", True, "7282687663872676408", "23897797", "e692fae669650c948451b5811a04e7e6", [
+                                    EffectParam("强度", 1.000, 0.000, 1.000)])
+    """参数:
+        - 强度: 默认1.00, 0.00 ~ 1.00
+    """
+    百老汇      = EffectMeta("百老汇", True, "7372150379150053907", "66413025", "73e3a35496b9766d0400165844be72f1", [
+                                    EffectParam("strength", 1.000, 0.000, 1.000)])
+    """参数:
+        - strength: 默认1.00, 0.00 ~ 1.00
+    """
+    空灵感      = EffectMeta("空灵感", True, "7350215092975178252", "53187171", "aa1887a8b3375d20df6bf9438d62083a", [
+                                    EffectParam("强度", 1.000, 0.000, 1.000)])
+    """参数:
+        - 强度: 默认1.00, 0.00 ~ 1.00
+    """
+    空谷回声    = EffectMeta("空谷回声", True, "7350214991628210727", "53187170", "9913daa32167a17c1f41ad2f5596c411", [
+                                    EffectParam("强度", 1.000, 0.000, 1.000)])
+    """参数:
+        - 强度: 默认1.00, 0.00 ~ 1.00
+    """
+    老式电话    = EffectMeta("老式电话", True, "7282691476843139621", "23880011", "2eb835175e1e72e9d86b09bf513077cf", [
+                                    EffectParam("强度", 1.000, 0.000, 1.000)])
+    """参数:
+        - 强度: 默认1.00, 0.00 ~ 1.00
+    """
+    言灵术      = EffectMeta("言灵术", True, "7382844601435951653", "72110974", "7184386e75226a36942c60a5d5bb5618", [
+                                    EffectParam("strength", 1.000, 0.000, 1.000)])
+    """参数:
+        - strength: 默认1.00, 0.00 ~ 1.00
+    """
+    豪宅回声    = EffectMeta("豪宅回声", True, "7360900963294515775", "58979353", "7c20b5fba991f3188f14d7cdb0de1fa1", [
+                                    EffectParam("强度", 1.000, 0.000, 1.000)])
+    """参数:
+        - 强度: 默认1.00, 0.00 ~ 1.00
+    """
+    迷幻电子    = EffectMeta("迷幻电子", True, "7375069381769826879", "68076026", "ce220d25a6f95bd31a81f6421bbf2525", [
+                                    EffectParam("strength", 1.000, 0.000, 1.000),
+                                    EffectParam("noise", 0.743, 0.000, 1.000)])
+    """参数:
+        - strength: 默认1.00, 0.00 ~ 1.00
+        - noise: 默认0.74, 0.00 ~ 1.00
+    """