一、简介

1. 利用OM Web API向OM上传一个语音文件，需要3~4步：
2. 上传的前提条件是已登录状态，如果未登录，则先执行登录；
3. 上传wav文件（upload）；
4. 升级（upgrade）；
5. 对wav文件进行格式转换（convertwav）。

二、上传的要求

1、名称要求

欢迎词：对可由字母、数字和下划线”_”组成，且必须以 user 开头，如：user_welcome.wav。
彩铃：可由字母、数字和下划线”_”组成，且必须以”fring”开头。

2、大小要求
文件大小不得超过 5MB。

3、格式要求
必须为 wav，采样速率仅支持 22.050kHz 或 8.000kHz。如果格式不满足要求，可先利用语音转换工具——风声进行格式转换，风声下载地址：www.newrocktech.com/ViewProduct.asp?id=61。

三、上传的步骤

注：HTTP包体和HTTP包体之间有空行，即使包体为空，也不能缺少空行。

步骤1：登录

请求示例：
GET /xml?method=gw.account.login&id51=admin HTTP/1.1
Host: 192.168.130.242
Content-Length: 0

参数说明：
id51的值为登录密码；

响应示例：

HTTP/1.0 200 OK
Date: Thu, 03 Mar 2016 03:17:54 GMT
Server: 
Cache-Control:no-cache
Pragma:no-cache
Expires:-1
Connection: close
Content-Type: text/xml
Content-Length: 147

步骤2：上传

请求示例：
POST /upload HTTP/1.1
Host: 192.168.140.108
Content-Length: 91248（//HTTP包体的总长度，而非文件的长度，且必须和实际长度丝毫不差）
Content-Type: multipart/form-data; boundary=----WebKitFormBoundaryNKFeu63Ti4RngOdy

------WebKitFormBoundaryNKFeu63Ti4RngOdy
Content-Disposition: form-data; name="welcome_user"; filename="user_test.wav"
Content-Type: audio/wav

user_test.wav的二进制流
------WebKitFormBoundaryNKFeu63Ti4RngOdy--

参数说明：
name（文件类型）
值为filename1，表示上传的是彩铃
值为welcome_user，表示上传的是欢迎词
filename（文件名称）

名称要求：
欢迎词：对可由字母、数字和下划线”_”组成，且必须以 user 开头。如：user_welcome.wav。
彩铃：可由字母、数字和下划线”_”组成，且必须以”fring”开头。

响应示例：
HTTP/1.0 200 OK
Content-Length: 84


ok
 

步骤3：升级

请求示例：
POST /upgrade HTTP/1.1
Host: 192.168.140.108
Content-Length: 1384
Content-Type: multipart/form-data; boundary=----WebKitFormBoundary9ipL58JIPTq6VXKa

------WebKitFormBoundary9ipL58JIPTq6VXKa
Content-Disposition: form-data; name="0"

u
------WebKitFormBoundary9ipL58JIPTq6VXKa
Content-Disposition: form-data; name="1"

p
------WebKitFormBoundary9ipL58JIPTq6VXKa
Content-Disposition: form-data; name="2"

g
------WebKitFormBoundary9ipL58JIPTq6VXKa
Content-Disposition: form-data; name="3"

r
------WebKitFormBoundary9ipL58JIPTq6VXKa
Content-Disposition: form-data; name="4"

a
------WebKitFormBoundary9ipL58JIPTq6VXKa
Content-Disposition: form-data; name="5"

d
------WebKitFormBoundary9ipL58JIPTq6VXKa
Content-Disposition: form-data; name="6"

e
------WebKitFormBoundary9ipL58JIPTq6VXKa
Content-Disposition: form-data; name="7"

=
------WebKitFormBoundary9ipL58JIPTq6VXKa
Content-Disposition: form-data; name="8"

u
------WebKitFormBoundary9ipL58JIPTq6VXKa
Content-Disposition: form-data; name="9"

p
------WebKitFormBoundary9ipL58JIPTq6VXKa
Content-Disposition: form-data; name="10"

g
------WebKitFormBoundary9ipL58JIPTq6VXKa
Content-Disposition: form-data; name="11"

r
------WebKitFormBoundary9ipL58JIPTq6VXKa
Content-Disposition: form-data; name="12"

a
------WebKitFormBoundary9ipL58JIPTq6VXKa
Content-Disposition: form-data; name="13"

d
------WebKitFormBoundary9ipL58JIPTq6VXKa
Content-Disposition: form-data; name="14"

e
------WebKitFormBoundary9ipL58JIPTq6VXKa--

响应示例：

HTTP/1.0 200 OK
Content-Length: 84

ok

步骤4：格式转换

请求示例：
GET /xml?method=gw.command.set&action=convertwav HTTP/1.1
Host: 192.168.140.108
Content-Length: 0

响应示例：

HTTP/1.0 200 OK
Date: Thu, 19 Nov 2015 06:46:20 GMT
Server: 
Cache-Control:no-cache
Pragma:no-cache
Expires:-1
Connection: close
Content-Type: text/xml
Content-Length: 112