<?php
namespace LaneWeChat\Core;
/**
 * 多媒体文件上传与下载管理类
 * 该类提供将图片、语音、视频等文件上传到微信服务器的功能，以及从微信服务器下载多媒体文件的功能。
 */
class Media {
    /**
     * 上传多媒体文件到微信服务器
     * 此方法允许上传图片、语音、视频等文件到微信服务器，并返回对应的media_id，用于后续获取多媒体文件。
     * 上传的文件有格式和大小限制，具体如下：
     * 图片（image）: 1M，支持JPG格式
     * 语音（voice）：2M，播放长度不超过60秒，支持AMR/MP3格式
     * 视频（video）：10MB，支持MP4格式
     * 缩略图（thumb）：64KB，支持JPG格式
     * 媒体文件在微信服务器的保存时间为3天，之后media_id将失效。
     *
     * @param string $filename 要上传的文件的绝对路径
     * @param string $type 媒体文件类型，可以是图片（image）、语音（voice）、视频（video）和缩略图（thumb）
     * @return array 上传成功后返回包含media_id和其他信息的数组
     */
    public static function upload($filename, $type) {
        // 获取微信公众号的ACCESS_TOKEN
        $accessToken = AccessToken::getAccessToken();
         // 构造多媒体文件上传的URL
        $queryUrl = 'http://file.api.weixin.qq.com/cgi-bin/media/upload?access_token=' . $accessToken . '&type=' . $type;
        // 准备上传的数据，使用'@'符号指定文件路径
        $data = array('media' => '@' . $filename);
        // 发起POST请求，上传文件
        return Curl::callWebServer($queryUrl, $data, 'POST', 1, 0);
    }


    /**
     * 从微信服务器下载多媒体文件
     * 此方法根据提供的media_id从微信服务器下载对应的多媒体文件。
     *
     * @param string $mediaId 微信服务器上的多媒体文件ID
     * @return mixed 下载的文件内容或下载失败的错误信息
     *
     * 下载多媒体文件时的HTTP头信息示例：
     * HTTP/1.1 200 OK
     * Connection: close
     * Content-Type: image/jpeg
     * Content-disposition: attachment; filename="MEDIA_ID.jpg"
     * Date: Sun, 06 Jan 2013 10:20:18 GMT
     * Cache-Control: no-cache, must-revalidate
     * Content-Length: 339721
     *
     * 使用curl命令下载多媒体文件的示例：
     * curl -G "http://file.api.weixin.qq.com/cgi-bin/media/get?access_token=ACCESS_TOKEN&media_id=MEDIA_ID"
     */
    public static function download($mediaId) {
        // 获取微信公众号的ACCESS_TOKEN
        $accessToken = AccessToken::getAccessToken();
        // 构造多媒体文件下载的URL
        $queryUrl = 'http://file.api.weixin.qq.com/cgi-bin/media/get?access_token=' . $accessToken . '&media_id=' . $mediaId;
        // 发起GET请求，下载文件
        return Curl::callWebServer($queryUrl, '', 'GET', 0);
    }
}