12.5.2 上传视频到Blip.TV

    Blip.TV是一个非常受欢迎的视频共享网站，其提供了一个基于REST的文件上传的API。可以使用它在捕获的应用程序上构建一个视频共享机制，或者甚至将它作为一个独立的应用程序。

    Blip.TV上传API的在线文档位于http://wiki.Blip.TV/index.php/REST_Upload_API，它详细介绍了在请求中可能包含的各种元素。特别是需要将上传文件的元素命名为“file”。为了运行示例代码，需要一个常规的Blip.TV用户登录(用户名)和密码(在实际应用程序中，它们应该由用户提供)。而且还需要一个title(标题)，同时需要包含值为“1”的post以及值为“api”的skin，以返回XML形式的响应。

    一旦通过API将视频上传到Blip.TV，他们就将以类似如下的XML进行响应:

   <response>

       <current_time>2010-10-30T00:13:00Z</current_time>

       <timestamp>1288397581081</timestamp>

       <status>OK</status>

       <payload>

             <asset>

                 <timestamp>1288397580</timestamp>

                 <id>4332695</id>

                 <item_type>file</item_type>

                 <item_id>4314031</item_id>

                 <links>

                     <link rel="alternate" type="text/html" href="http://blip.tv/file/4314031/" />

                     <link rel="alternate" type="application/rss+xml" href="http://blip.tv/ree/4332695/" />

                     <link rel="alternate" type="application/atom+xml" href="http://blip.tv/file/4314031/?skin=atom" />

                     <link rel="service.edit" type="text/html" href="http://blip.tv/file/post/4314031/" />

                     <link rel="service.edit" type="text/html" href="http://blip.tv/file/post/4314031/?skin=api" />

                 </links>

                 <files>

                     <file src="Username-AVideo562.3gp"  submitted_as="VID_20101029_200900.3gp" role='Source'/>

                 </files>

             </asset>

       </payload>

     </response>

     注意，如果上传成功，那么XML给出的状态是OK，并且在file元素中给出指向原始文件的链接。可以使用SAX分析器来分析这个XML，寻找这些条目并将视频返回给用户，以检查上传是否成功。

     如果上传失败，那么XML给出的状态时ERROR，并给出一个error的标记，其中包括编码和消息。下面是一个用户名/密码组合错误输入的示例。

     <response>

       <current_time>2010-10-30T00:18:32Z</current_time>

       <timestamp>1288399112662</timestamp>

       <status>ERROR</status>

        <error>

            <code>AUTHENTICATION_REQUIRED</code>

            <message>the operation you attempted to perform require authentication information is invalid,missing or insufficient for the action you are attempting to perform.</message>

        </error>

     </response>

     接下来看一下捕获视频并上传到Blip.TV的完整代码：

package com.nthm.androidtestActivity;

import java.io.File;
import java.io.FilterOutputStream;
import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStream;
import java.io.UnsupportedEncodingException;
import javax.xml.parsers.ParserConfigurationException;
import javax.xml.parsers.SAXParser;
import javax.xml.parsers.SAXParserFactory;
import org.apache.http.HttpEntity;
import org.apache.http.HttpResponse;
import org.apache.http.client.ClientProtocolException;
import org.apache.http.client.HttpClient;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.entity.mime.MultipartEntity;
import org.apache.http.entity.mime.content.FileBody;
import org.apache.http.entity.mime.content.StringBody;
import org.apache.http.impl.client.DefaultHttpClient;
import org.xml.sax.Attributes;
import org.xml.sax.InputSource;
import org.xml.sax.SAXException;
import org.xml.sax.XMLReader;
import org.xml.sax.helpers.DefaultHandler;
import com.nthm.androidtest.R;
import android.app.Activity;
import android.content.Intent;
import android.database.Cursor;
import android.net.Uri;
import android.os.AsyncTask;
import android.os.Bundle;
import android.widget.TextView;

public class BlipTVUploader extends Activity {

    该活动将使用一个意图来触发Camera活动以进行视频录制，同时触发默认的活动以进行视频播放，因此需要设置两个常量来获知返回了哪个活动。

    private final static int VIDEO_CAPTURED=0;
    private final static int VIDEO_PLAYED=0;

    还需要几个变量：File变量表示SD卡上的捕获视频，字符串类型的title是上传到Blip.TV时的视频标题，还有用于Blip.TV的username和password。在实际应用程序中，应该从用户处获得title、username和password。

    private File videoFile;
    private String title="A Video";
    private String username="BLIPTV_USERNAME";
    private String password="BLIPTV_PASSWORD";

    postingResult变量将包含上传之后在Blip.TV的XML响应中给定的结果。

    private String postingResult="";

    在录制视频之后，设置fileLength变量，从而可以跟踪文件的上传进度。

    private long fileLength=0;

    我们将使用一个TextView来向用户显示上传的进度和其他信息。

    private TextView textview;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.bliptvuploader);
        textview=(TextView) findViewById(R.id.textview);

    当第一次启动时，我们将使用一个意图来触发默认的视频捕获应用程序，通常是启动内置的Camera活动，使得用户能够捕获视频。将VIDEO_CAPTURED常量连同意图一起传递给startActivityForResult，从而在onActivityResult中可以知道返回的是什么内容。

        Intent captureVideoIntent=new Intent(android.provider.MediaStore.ACTION_VIDEO_CAPTURE);
        startActivityForResult(captureVideoIntent, VIDEO_CAPTURED);
    }

    @Override
    protected void onActivityResult(int requestCode, int resultCode, Intent data) {

    当Camera活动返回时可以获得视频文件的Uri，就像是以第11章所描述的方式捕获它一样。

        super.onActivityResult(requestCode, resultCode, data);
        if(resultCode==RESULT_OK&&requestCode==VIDEO_CAPTURED){
            Uri videoFileUri=data.getData();

    为了获得SD卡上的实际视频文件，需要查询MediaStore，请求表示该文件的DATA列。

            String [] columns={android.provider.MediaStore.Video.Media.DATA};
            Cursor cursor=managedQuery(videoFileUri, columns, null, null, null);
            int fileColumn=cursor.getColumnIndexOrThrow(android.provider.MediaStore.Video.Media.DATA);
            if(cursor.moveToFirst()){
                String videoFilePath=cursor.getString(fileColumn);

    一旦获得了该文件的路径，就可以构造File对象，获得它的长度，并实例化一个BlipTVFilePoster对象。由于BlipTVFilePoster扩展了AsyncTask，因此为了启动它以使其执行操作，可以调用它的execute方法。

                videoFile=new File(videoFilePath);
                fileLength=videoFile.length();
                BlipTVFilePoster tvfp=new BlipTVFilePoster();
                tvfp.execute();
            }

    如果返回的是视频播放器活动，那么只须简单的结束，这样就完成了所有的工作。

        }else if(requestCode==VIDEO_PLAYED){
            finish();
        }
    }

    如前所述，BlipTVFilePoster扩展了AsyncTask。因此，它可以在后台线程中工作，而不会绑定界面。此外，它还会实现ProgressListener，该接口旨在处理来自上传类的进度回调；同时它还实现了BlipXMLParserListener，从而处理来自XML分析类的回调。

    class BlipTVFilePoster extends AsyncTask<Void, String, Void> implements ProgressListener,BlipXMLParserListener{

    变量videoUrl将包含上传至Blip.TV之后指向视频文件的URL。

        private String videoUrl;
        @Override
        protected Void doInBackground(Void... params) {

    如前所述，可以通过MultipartEntity使用HttpClient来执行HTTP文件上传。

            HttpClient httpclient=new DefaultHttpClient();
            HttpPost httppost=new HttpPost("http://blip.tv/file/post");

    在此示例中使用了一个ProgressMultipartEntity类，其扩展了MultipartEntity，但是允许跟踪传递的过程。因为实现了ProgressListener，所以可以将自身作为监听器传入。

            ProgressMultipartEntity multipartEntity =new ProgressMultipartEntity(this);

    需要在帖子中添加Blip.TV所需的几个部分。当然，我们需要file，但是还将需要userlogin(用户名)、password、title、值为“1”的post——从而会真正发布它，并且需要值为“api”的skin——从而能够获得XML作为响应，而不是获得一个正常的网页。

            try {
                multipartEntity.addPart("file",new FileBody(videoFile));
                multipartEntity.addPart("userlogin", new StringBody(username));
                multipartEntity.addPart("password", new StringBody(password));
                multipartEntity.addPart("title", new StringBody(title));
                multipartEntity.addPart("post", new StringBody("1"));
                multipartEntity.addPart("skin", new StringBody("api"));
                httppost.setEntity(multipartEntity);
                HttpResponse httpresponse=httpclient.execute(httppost);
                HttpEntity responseentity=httpresponse.getEntity();
                if(responseentity!=null){

    一旦执行完HTTP文件上传，就可以获得一个InputStream，以从服务器读取响应。在当前情况下，只需要将该InputStream传递给SAX分析器的一个实现，从而可以确定上传是否成功。

                    InputStream inputstream=responseentity.getContent();
                    SAXParserFactory aSAXParserFactory=SAXParserFactory.newInstance();
                    try {
                        SAXParser aSAXParser=aSAXParserFactory.newSAXParser();
                        XMLReader anXMLReader=aSAXParser.getXMLReader();

    我们将使用下面定义的BlipResponseXMLHandler来专门处理在上传文件之后来自Blip.TV的XML响应。

                        anXMLReader.setContentHandler(xmlHandler);
                        anXMLReader.parse(new InputSource(inputstream));
                    } catch (ParserConfigurationException e) {
                        e.printStackTrace();
                    } catch (SAXException e) {
                        e.printStackTrace();
                    }
                    inputstream.close();
                }
            } catch (UnsupportedEncodingException e) {
                e.printStackTrace();
            }catch (ClientProtocolException e) {
                e.printStackTrace();
            } catch (IOException e) {
                e.printStackTrace();
            }
            return null;
        }

    正如通常的AsyncTask一样，当调用publishProgress时最终将触发onProgressUpdate方法，但是与doInBackground方法不同，该方法可以直接与UI线程交互。

        @Override
        protected void onProgressUpdate(String... values) {
            textview.setText(values[0]);
        }

    当完成doInBackground方法时，触发onPostExecute方法，当发生该事件时，如果XML分析器已经填充了videoUrl变量，就只须创建一个意图，以使用默认的视频播放器活动播放上传的文件。

    @Override
        protected void onPostExecute(Void result) {
            if(videoUrl!=null){
                Intent viewVideoIntent=new Intent(Intent.ACTION_VIEW);
                Uri uri=Uri.parse("http://blip.tv/file/get/"+videoUrl);
                viewVideoIntent.setDataAndType(uri, "video/3gpp");
                startActivityForResult(viewVideoIntent, VIDEO_PLAYED);
            }
        }

    下面定义的transferred方法是ProgressListener接口必须实现的一部分。当文件正在上传时，该方法将被ProgressMultipartEntity调用。transferred方法将调用publishProgress方法，这将触发onProgressUpdate方法来更新UI。

        @Override
        public void transferred(long num) {
            double percent=(double)num/(double)fileLength;
            int percentInt=(int)(percent*100);
            publishProgress(""+percentInt+"% Transferred");
        }

    parseResult方法是BlipXMLParserListener实现所必须的一部分。当正在分析应向用户报告的XML时将调用这个方法。它仅仅调用publishProgress，这回触发onProgressUpdate以向用户显示结果。

        @Override
        public void parseResult(String result) {
            publishProgress(result);
        }

    setVideoUrl方法也是BlipXMLParserListener实现所必须的一部分。它只是在已上传视频后使用视频的URL填充videoUrl变量。

        @Override
        public void setVideoUrl(String url) {
            videoUrl=url;
        }
     }

    下面扩展了MultipartEntity的ProgressMultipartEntity。这个类包含了ProgressListener，从而可以报告进度；同时它重写了writeTo方法，以使用可以计算流出字节数的OutputStream。

    class ProgressMultipartEntity extends MultipartEntity{
        ProgressListener progressListener;
        
        public ProgressMultipartEntity(ProgressListener progressListener) {
            super();
            this.progressListener = progressListener;
        }

        @Override
        public void writeTo(OutputStream outstream) throws IOException {
            super.writeTo(new ProgressOutputStream(outstream, this.progressListener));
        }
    }

    ProgressListener接口非常的简单，它仅仅指定在实现类中需要有一个transferred方法。

    interface ProgressListener{
        void transferred(long num);
    }

    下面是ProgressOutputStream，其重写了FilterOutputStream中的write方法，同时跟踪已传输的字节数。

    static class ProgressOutputStream extends FilterOutputStream{
        ProgressListener listener;
        int transferred;
        public ProgressOutputStream(OutputStream out,ProgressListener listener) {
            super(out);
            this.listener=listener;
            this.transferred=0;
        }
        @Override
        public void write(byte[] buffer, int offset, int length)
                throws IOException {
            out.write(buffer, offset, length);
            this.transferred+=length;
            this.listener.transferred(this.transferred);
        }
        @Override
        public void write(int oneByte) throws IOException {
            out.write(oneByte);
            this.transferred++;
            this.listener.transferred(this.transferred);
        }
    }

    最后还包括BlipXMLParserListener接口和BlipResponseXMLHandler，他们处理Blip.TV为响应文件上传而传输的XML。

    interface BlipXMLParserListener{
        void parseResult(String result);
        void setVideoUrl(String url);
    }
    class BlipResponseXMLHandler extends DefaultHandler{

    下面的常量将结合state变量来跟踪当前在XML中的位置。

        int NONE=0;
        int ONSTATUS=1;
        int ONFILE=2;
        int ONERRORMESSAGE=3;
        
        int state=NONE;

    下一组常量定义XML中可能返回的状态值。我们将只用这些常量来跟踪下面定义的status整数中的状态。

        int STATUS_UNKNOWN=0;
        int STATUS_OK=1;
        int STATUS_ERROR=2;
        
        int status=STATUS_UNKNOWN;

    message变量将包含从XML返回的错误信息；或者如果上传成功，那么它包含视频的URL。

        String message="";

    当然，需要保存通过构造函数传入的BlipXMLParserListener。

        BlipXMLParserListener listener;

        public BlipResponseXMLHandler(BlipXMLParserListener bxpl) {
            super();
            listener=bxpl;
        }

        @Override
        public void startDocument() throws SAXException {
            super.startDocument();
        }

        @Override
        public void endDocument() throws SAXException {
            super.endDocument();
        }

    需要在startElement标记中完成许多的工作。检查包含XML标记名称的localName变量，以判断它是否匹配任何需要注意的内容；如果匹配，那么将state变量设置为合适的常量。

        @Override
        public void startElement(String uri, String localName, String qName,
                Attributes attributes) throws SAXException {
            if(localName.equalsIgnoreCase("status")){
                state=ONSTATUS;
            }else if(localName.equalsIgnoreCase("file")){
                state=ONFILE;

    如果是file元素，那么通知监听器，同时提取出src属性，它是上传文件之后Blip.TV分配给他的文件名。

                listener.parseResult("onFile");
                message=attributes.getValue("src");
                listener.parseResult("filemessage:"+message);

    随后，通过setVideoUrl方法将文件传递给BlipXMLParserListener。

                listener.setVideoUrl(message);
            }else if(localName.equalsIgnoreCase("message")){
                state=ONERRORMESSAGE;
                listener.parseResult("onErrorMessage");
            }
        }

        @Override
        public void endElement(String uri, String localName, String qName)
                throws SAXException {
            if(localName.equalsIgnoreCase("status")){
                state=NONE;
            }else if(localName.equalsIgnoreCase("file")){
                state=NONE;
            }else if(localName.equalsIgnoreCase("message")){
                state=NONE;
            }
        }

    当在一个元素中发现任何内容时，将触发characters方法。如果state变量表明正在读取一个需要关注的元素，那么会采取相应的操作。

        @Override
        public void characters(char[] ch, int start, int length)
                throws SAXException {
            String stringChars=new String(ch, start, length);

    如果正在读取状态元素，那么将status变量设置为合适的常量。

            if(state==ONSTATUS){
                if(stringChars.equalsIgnoreCase("OK")){
                    status=STATUS_OK;
                }else if(stringChars.equalsIgnoreCase("ERROR")){
                    status=STATUS_ERROR;
                }else{
                    status=STATUS_UNKNOWN;
                }

    如果正在读取错误消息元素，那么获得相应的文本并将它设置为message变量，同时将它发送到监听器。

            }else if(state==ONERRORMESSAGE){
                message+=stringChars.trim();
                listener.parseResult(message);
            }
        }
    }
}

    在上述示例中用来跟踪文件上传进度的方法是基于“tuler”所提供的答案。该答案是由ColinD编辑的关于栈溢出(Stack Overflow)问题的回答，栈溢出问题由SoaperGEM在如下页面提出：

     http://stackoverflow.com/questions/254719/file-upload-with-java-with-progressbar/470047#470047。

    下面是上述活动使用的布局XML。

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    >
 <TextView 
     android:id="@+id/textview"
     android:text=""
     android:layout_width="fill_parent"
     android:layout_height="wrap_content"
     android:textSize="35dip"></TextView>

</LinearLayout>

    上述示例演示了如何允许用户直接将创建的视频发布到一个网络视频共享平台。当然，类似的代码还可以用于发布到其他的共享平台，且不限于视频：可以将图像上传到Flickr或Picasa；也可以将音频文件上传到音频共享网站。