diff --git a/core/responsepassive.lib.php b/core/responsepassive.lib.php index a85a367..46e99e0 100644 --- a/core/responsepassive.lib.php +++ b/core/responsepassive.lib.php @@ -1,5 +1,6 @@ @@ -34,14 +35,14 @@ XML; } /** - * @descrpition 图片 - * @param $fromusername - * @param $tousername - * @param $mediaId 通过上传多媒体文件，得到的id。 + * @description 图片消息 + * @param $fromusername 发送方的OpenId + * @param $tousername 接收方的OpenId + * @param $mediaId 通过上传多媒体文件，得到的id * @param $funcFlag 默认为0，设为1时星标刚才收到的消息 - * @return string + * @return string 返回XML格式的图片消息 */ - public static function image($fromusername, $tousername, $mediaId, $funcFlag=0){ + public static function image($fromusername, $tousername, $mediaId, $funcFlag=0) { $template = << @@ -58,14 +59,14 @@ XML; } /** - * @descrpition 语音 - * @param $fromusername - * @param $tousername + * @description 语音消息 + * @param $fromusername 发送方的OpenId + * @param $tousername 接收方的OpenId * @param $mediaId 通过上传多媒体文件，得到的id * @param $funcFlag 默认为0，设为1时星标刚才收到的消息 - * @return string + * @return string 返回XML格式的语音消息 */ - public static function voice($fromusername, $tousername, $mediaId, $funcFlag=0){ + public static function voice($fromusername, $tousername, $mediaId, $funcFlag=0) { $template = << @@ -82,16 +83,16 @@ XML; } /** - * @descrpition 视频 - * @param $fromusername - * @param $tousername + * @description 视频消息 + * @param $fromusername 发送方的OpenId + * @param $tousername 接收方的OpenId * @param $mediaId 通过上传多媒体文件，得到的id * @param $title 标题 * @param $description 描述 * @param $funcFlag 默认为0，设为1时星标刚才收到的消息 - * @return string + * @return string 返回XML格式的视频消息 */ - public static function video($fromusername, $tousername, $mediaId, $title, $description, $funcFlag=0){ + public static function video($fromusername, $tousername, $mediaId, $title, $description, $funcFlag=0) { $template = << @@ -110,18 +111,18 @@ XML; } /** - * @descrpition 音乐 - * @param $fromusername - * @param $tousername + * @description 音乐消息 + * @param $fromusername 发送方的OpenId + * @param $tousername 接收方的OpenId * @param $title 标题 * @param $description 描述 * @param $musicUrl 音乐链接 * @param $hqMusicUrl 高质量音乐链接，WIFI环境优先使用该链接播放音乐 * @param $thumbMediaId 缩略图的媒体id，通过上传多媒体文件，得到的id * @param $funcFlag 默认为0，设为1时星标刚才收到的消息 - * @return string + * @return string 返回XML格式的音乐消息 */ - public static function music($fromusername, $tousername, $title, $description, $musicUrl, $hqMusicUrl, $thumbMediaId, $funcFlag=0){ + public static function music($fromusername, $tousername, $title, $description, $musicUrl, $hqMusicUrl, $thumbMediaId, $funcFlag=0) { $template = << @@ -142,15 +143,15 @@ XML; } /** - * @descrpition 图文消息 - 单个项目的准备工作，用于内嵌到self::news()中。现调用本方法，再调用self::news() + * @description 图文消息 - 单个项目的准备工作，用于内嵌到self::news()中。现调用本方法，再调用self::news() * 多条图文消息信息，默认第一个item为大图,注意，如果调用本方法得到的数组总项数超过10，则将会无响应 * @param $title 标题 * @param $description 描述 * @param $picUrl 图片链接，支持JPG、PNG格式，较好的效果为大图360*200，小图200*200 * @param $url 点击图文消息跳转链接 - * @return string + * @return string 返回XML格式的图文消息项 */ - public static function newsItem($title, $description, $picUrl, $url){ + public static function newsItem($title, $description, $picUrl, $url) { $template = << <![CDATA[%s]]> @@ -163,19 +164,18 @@ XML; } /** - * @descrpition 图文 - 先调用self::newsItem()再调用本方法 - * @param $fromusername - * @param $tousername + * @description 图文消息 - 先调用self::newsItem()再调用本方法 + * @param $fromusername 发送方的OpenId + * @param $tousername 接收方的OpenId * @param $item 数组，每个项由self::newsItem()返回 * @param $funcFlag 默认为0，设为1时星标刚才收到的消息 - * @return string + * @return string 返回XML格式的图文消息 */ - public static function news($fromusername, $tousername, $item, $funcFlag=0){ + public static function news($fromusername, $tousername, $item, $funcFlag=0) { //多条图文消息信息，默认第一个item为大图,注意，如果图文数超过10，则将会无响应 if(count($item) >= 10){ $request = array('fromusername'=>$fromusername, 'tousername'=>$tousername); return Msg::returnErrMsg(MsgConstant::ERROR_NEWS_ITEM_COUNT_MORE_TEN, '图文消息的项数不能超过10条', $request); - } $template = << @@ -183,32 +183,190 @@ XML; %s - %s - - %s - + %s + + + %s + + %s XML; - return sprintf($template, $fromusername, $tousername, time(), count($item), implode($item), $funcFlag); + return sprintf($template, $fromusername, $tousername, time(), $content, $funcFlag); } /** - * 将消息转发到多客服 - * 如果公众号处于开发模式，需要在接收到用户发送的消息时，返回一个MsgType为transfer_customer_service的消息，微信服务器在收到这条消息时，会把这次发送的消息转到多客服系统。用户被客服接入以后，客服关闭会话以前，处于会话过程中，用户发送的消息均会被直接转发至客服系统。 - * @param $fromusername - * @param $tousername - * @return string + * @description 图片消息 + * @param $fromusername 发送方的OpenId + * @param $tousername 接收方的OpenId + * @param $mediaId 通过上传多媒体文件，得到的id + * @param $funcFlag 默认为0，设为1时星标刚才收到的消息 + * @return string 返回XML格式的图片消息 */ - public static function forwardToCustomService($fromusername, $tousername){ + public static function image($fromusername, $tousername, $mediaId, $funcFlag=0) { $template = << %s - + + + + + %s XML; - return sprintf($template, $fromusername, $tousername, time()); + return sprintf($template, $fromusername, $tousername, time(), $mediaId, $funcFlag); } -} \ No newline at end of file + + /** + * @description 语音消息 + * @param $fromusername 发送方的OpenId + * @param $tousername 接收方的OpenId + * @param $mediaId 通过上传多媒体文件，得到的id + * @param $funcFlag 默认为0，设为1时星标刚才收到的消息 + * @return string 返回XML格式的语音消息 + */ + public static function voice($fromusername, $tousername, $mediaId, $funcFlag=0) { + $template = << + + + %s + + + + + %s + +XML; + return sprintf($template, $fromusername, $tousername, time(), $mediaId, $funcFlag); + } + + /** + * @description 视频消息 + * @param $fromusername 发送方的OpenId + * @param $tousername 接收方的OpenId + * @param $mediaId 通过上传多媒体文件，得到的id + * @param $title 标题 + * @param $description 描述 + * @param $funcFlag 默认为0，设为1时星标刚才收到的消息 + * @return string 返回XML格式的视频消息 + */ + public static function video($fromusername, $tousername, $mediaId, $title, $description, $funcFlag=0) { + $template = << + + + %s + + + %s + +XML; + return sprintf($template, $fromusername, $tousername, time(), $mediaId, $title, $description, $funcFlag); + } + + /** + * @description 音乐消息 + * @param $fromusername 发送方的OpenId + * @param $tousername 接收方的OpenId + * @param $title 标题 + * @param $description 描述 + * @param $musicUrl 音乐链接 + * @param $hqMusicUrl 高质量音乐链接，WIFI环境优先使用该链接播放音乐 + * @param $thumbMediaId 缩略图的媒体id，通过上传多媒体文件，得到的id + * @param $funcFlag 默认为0，设为1时星标刚才收到的消息 + * @return string 返回XML格式的音乐消息 + */ + public static function music($fromusername, $tousername, $title, $description, $musicUrl, $hqMusicUrl, $thumbMediaId, $funcFlag=0) { + $template = << + + + %s + + + <![CDATA[%s]]> + + + + + + %s + +XML; + return sprintf($template, $fromusername, $tousername, time(), $title, $description, $musicUrl, $hqMusicUrl, $thumbMediaId, $funcFlag); + } + + /** + * @description 图文消息 - 单个项目的准备工作，用于内嵌到self::news()中。现调用本方法，再调用self::news() + * 多条图文消息信息，默认第一个item为大图,注意，如果调用本方法得到的数组总项数超过10，则将会无响应 + * @param $title 标题 + * @param $description 描述 + * @param $picUrl 图片链接，支持JPG、PNG格式，较好的效果为大图360*200，小图200*200 + * @param $url 点击图文消息跳转链接 + * @return string 返回XML格式的图文消息项 + */ + public static function newsItem($title, $description, $picUrl, $url) { + $template = << + <![CDATA[%s]]> + + + + +XML; + return sprintf($template, $title, $description, $picUrl, $url); + } + + /** + * @description 图文消息 - 先调用self::newsItem()再调用本方法 + * @param $fromusername 发送方的OpenId + * @param $tousername 接收方的OpenId + * @param $item 数组，每个项由self::newsItem()返回 + * @param $funcFlag 默认为0，设为1时星标刚才收到的消息 + * @return string 返回XML格式的图文消息 + */ + public static function news($fromusername, $tousername, $item, $funcFlag=0) { + //多条图文消息信息，默认第一个item为大图,注意，如果图文数超过10，则将会无响应 + if(count($item) >= 10){ + $request = array('fromusername'=>$fromusername, 'tousername'=>$tousername); + return Msg::returnErrMsg(MsgConstant::ERROR_NEWS_ITEM_COUNT_MORE_TEN, '图文消息的项数不能超过10条', $request); + } + $template = << + + + %s + + %s