archived-MoviePilot-Plugins/docs/faq/05-enhance-recognition.md

如何通过插件增强MoviePilot的识别功能？

返回 README | FAQ 索引

• V1按如下步骤实现，V2版本直接实现对应链式事件即可，参考ChatGPT插件。注意：只有主程序无法识别时才会触发。

• 注册 NameRecognize 事件，实现识别逻辑。

  @eventmanager.register(EventType.NameRecognize)
  

• 完成识别后发送 NameRecognizeResult 事件，将识别结果注入主程序

  eventmanager.send_event(
      EventType.NameRecognizeResult,
      {
          'title': title, # 原传入标题
          'name': str, # 识别的名称
          'year': str, # 识别的年份
          'season': int, # 识别的季号
          'episode': int, # 识别的集号
      }
  )
  

• 注意：识别请求需要在15秒内响应，否则结果会被丢弃；插件未启用或参数不完整时应立即回复空结果事件，避免主程序等待； 多个插件开启识别功能时，以先收到的识别结果事件为准。

  eventmanager.send_event(
      EventType.NameRecognizeResult,
      {
          'title': title # 结果只含原标题，代表空识别结果事件
      }
  )