==============
**富媒体信息**
==============

获取图片基本信息
================

描述
----

获取图片基本信息，如图片类型（jpg，png等）、图片宽度（Width）和高度（Height）等。

接口
----

GET /${ObjectKey}?imageInfo HTTP/1.1

参数
----

.. list-table::
    :widths: 10 40
    :header-rows: 1

    * - 名称	
      - 描述
    * - imageInfo
      - 获取图片基本信息操作标识符，值为空
      
返回值
------

.. list-table::
    :widths: 10 20 20
    :header-rows: 1

    * - 名称	
      - 描述
      - 是否必须
    * - Height
      - 图像高度
      - 是
    * - Width
      - 图像宽度
      - 是
    * - Size
      - 图像大小
      - 是
    * - Type
      - 图像类型
      - 是
    * - Orientation
      - 旋转方向
      - 否

      
示例
----

http://img-sample.nos-eastchina1.126.net/Koala.jpg?imageInfo

.. code:: xml
    :number-lines:
    
	<?xml version="1.0" encoding="UTF-8"?>
	<ImageInfoResult>
           <Width>1024</Width>
           <Height>768</Height>
           <Size>780831</Size>
           <Type>JPEG</Type>
           <Orientation/>
	</ImageInfoResult>
		


获取图片EXIF信息
================

描述
----

获取图片的exif信息，如作者，拍摄时间等

接口
----

GET /${ObjectKey}?exif HTTP/1.1


参数
----

.. list-table::
    :widths: 10 40
    :header-rows: 1

    * - 名称	
      - 描述
    * - exif
      - 获取图片的exif信息，值为空
      
返回值
------

包含exif信息的json体

      
示例
----

\ http://img-sample.nos-eastchina1.126.net/Koala.jpg?imageInfo\

.. code::
    :number-lines:
    
    {
        Exif: {
	    Image: {
	        0xea1c: "",
		Artist: "Corbis",
		DateTime: "2009:03:12 13:48:28",
		ExifTag: "125",
		Rating: "4",
		RatingPercent: "63",
		XPAuthor: ""
	    },
	    Photo: {
		0xea1c: "",
		DateTimeDigitized: "2008:02:11 11:32:43",
		DateTimeOriginal: "2008:02:11 11:32:43",
		SubSecTimeDigitized: "17",
		SubSecTimeOriginal: "17"
	    },
	    Thumbnail: {
		Compression: "JPEG (old-style)",
		JPEGInterchangeFormat: "313",
		JPEGInterchangeFormatLength: "4834",
		XResolution: "72",
		YResolution: "72"
	    }
	}
    }


去除图片元数据
==============

描述
----

去除或保留图片如作者，拍摄设备等元数据。

接口
----

GET /${ObjectKey}?imageView&stripmeta=0 HTTP/1.1


参数
----

.. list-table::
    :widths: 10 20 20
    :header-rows: 1

    * - 名称	
      - 描述
      - 取值范围
    * - stripmeta
      - 元数据操作的关键字
      - 0和1，0保留元数据，1去除元数据
      
示例
----

保留图片元数据：

效果图：\ http://img-sample.nos-eastchina1.126.net/Koala.jpg?imageView&stripmeta=0\


获取视频信息
============

描述
----

用于获取视频基本信息，需以vinfo作为请求操作标识

接口
----

GET /${ObjectKey}?vframe HTTP/1.1


参数
----

.. list-table::
    :widths: 10 40
    :header-rows: 1

    * - 名称	
      - 描述
    * - vinfo
      - 获取视频的基本信息，值为空
      
返回值
------

包含视频信息的json体

      
示例
----

\ http://img-sample.nos-eastchina1.126.net/sample.wmv?vinfo\

.. code::
    :number-lines:
    
    {
	GetVideoInfo: {
	    VideoInfo: {
		FrameRate: 0,
		VideoBitrate: 5802,
		VideoCodec: "vc1 (Advanced) (WVC1 / 0x31435657)",
		Duration: 30093,
		Width: 1280,
		Encoder: "",
		AudioBitrate: 187,
		AudioCodec: "wmav2 (a[1][0][0] / 0x0161)",
		Height: 720,
		Start: 0,
		Rotate: 0,
		Size: 26246026,
		Container: "asf"
	    },
	    Object: "sample.wmv",
	    Bucket: "img-sample"
	}
    }