From 8735e8c142fb54e0444ce55984e50ef1d3b50802 Mon Sep 17 00:00:00 2001
From: mlg6veufz <3318209438@qq.com>
Date: Wed, 8 Jan 2025 21:39:06 +0800
Subject: [PATCH] Update responsepassive.lib.php

---
 core/responsepassive.lib.php | 67 +++++++++++++++++++++++++++++++++++-
 1 file changed, 66 insertions(+), 1 deletion(-)

diff --git a/core/responsepassive.lib.php b/core/responsepassive.lib.php
index 46e99e0..8f9a79e 100644
--- a/core/responsepassive.lib.php
+++ b/core/responsepassive.lib.php
@@ -369,4 +369,69 @@ XML;
     <FromUserName><![CDATA[%s]]></FromUserName>
     <CreateTime>%s</CreateTime>
     <MsgType><![CDATA[news]]></MsgType>
-    <ArticleCount>%s</ArticleCount
\ No newline at end of file
+    <ArticleCount>%s</ArticleCount
+
+ResponsePassive 类是一个用于微信公众号被动响应消息的工具类，它封装了各种消息类型的发送方法，使得开发者能够方便地根据用户请求回复不同形式的消息。以下是该类中各方法的详细讲解：
+
+文本消息
+功能：用于回复文本内容给用户。
+参数：
+$fromusername：发送方的OpenId，即公众号的OpenId。
+$tousername：接收方的OpenId，即用户的OpenId。
+$content：要回复的文本内容，支持换行，微信客户端会按换行显示。
+$funcFlag：默认为0，设为1时星标刚才收到的消息，方便用户快速找到。
+返回值：返回一个XML格式的文本消息字符串，包含消息的接收方、发送方、创建时间、消息类型以及文本内容等字段。
+图片消息
+功能：用于回复图片给用户。
+参数：
+$fromusername：发送方的OpenId，即公众号的OpenId。
+$tousername：接收方的OpenId，即用户的OpenId。
+$mediaId：通过上传多媒体文件到微信服务器，得到的图片媒体id。
+$funcFlag：默认为0，设为1时星标刚才收到的消息。
+返回值：返回一个XML格式的图片消息字符串，包含消息的接收方、发送方、创建时间、消息类型以及图片媒体id等字段。
+语音消息
+功能：用于回复语音给用户。
+参数：
+$fromusername：发送方的OpenId，即公众号的OpenId。
+$tousername：接收方的OpenId，即用户的OpenId。
+$mediaId：通过上传多媒体文件到微信服务器，得到的语音媒体id。
+$funcFlag：默认为0，设为1时星标刚才收到的消息。
+返回值：返回一个XML格式的语音消息字符串，包含消息的接收方、发送方、创建时间、消息类型以及语音媒体id等字段。
+视频消息
+功能：用于回复视频给用户。
+参数：
+$fromusername：发送方的OpenId，即公众号的OpenId。
+$tousername：接收方的OpenId，即用户的OpenId。
+$mediaId：通过上传多媒体文件到微信服务器，得到的视频媒体id。
+$title：视频消息的标题。
+$description：视频消息的描述。
+$funcFlag：默认为0，设为1时星标刚才收到的消息。
+返回值：返回一个XML格式的视频消息字符串，包含消息的接收方、发送方、创建时间、消息类型、视频媒体id、标题、描述等字段。
+音乐消息
+功能：用于回复音乐给用户。
+参数：
+$fromusername：发送方的OpenId，即公众号的OpenId。
+$tousername：接收方的OpenId，即用户的OpenId。
+$title：音乐消息的标题。
+$description：音乐消息的描述。
+$musicUrl：音乐链接，用户点击后会跳转到该链接播放音乐。
+$hqMusicUrl：高质量音乐链接，WIFI环境下优先使用该链接播放音乐。
+$thumbMediaId：缩略图的媒体id，通过上传多媒体文件到微信服务器得到。
+$funcFlag：默认为0，设为1时星标刚才收到的消息。
+返回值：返回一个XML格式的音乐消息字符串，包含消息的接收方、发送方、创建时间、消息类型、音乐链接、高质量音乐链接、缩略图媒体id等字段。
+图文消息 - 单个项目的准备工作
+功能：准备图文消息的单个项目，用于内嵌到news()方法中组装成完整的图文消息。
+参数：
+$title：图文消息的标题。
+$description：图文消息的描述。
+$picUrl：图片链接，支持JPG、PNG格式，大图建议360200，小图建议200200。
+$url：点击图文消息跳转的链接。
+返回值：返回一个XML格式的图文消息项字符串，包含标题、描述、图片链接、跳转链接等字段。
+图文消息
+功能：用于回复图文消息给用户。
+参数：
+$fromusername：发送方的OpenId，即公众号的OpenId。
+$tousername：接收方的OpenId，即用户的OpenId。
+$item：数组，每个项由newsItem()方法返回的图文消息项。
+$funcFlag：默认为0，设为1时星标刚才收到的消息。
+返回值：返回一个XML格式的图文消息字符串，包含消息的接收方、发送方、创建时间、消息类型、图文消息项数量以及各个图文消息项的内容。需要注意的是，图文消息的项数不能超过10条，否则将会无响应
\ No newline at end of file