现在的位置: 首页 > 综合 > 正文

也来玩转Skype ——基于Skype4Java API编写Skype外壳程序入门介绍

2013年11月04日 ⁄ 综合 ⁄ 共 5341字 ⁄ 字号 评论关闭

     Skype4Java API开发包官方下载地址:   

     https://developer.skype.com/wiki/Java_API

     在这篇文章中使用到了其中一个例子以及改进后的例子下载地址为:

    Skype4Java开发文档以及示例代码

     http://download.csdn.net/down/236693/lin_bei

Ø         Skype4Java架构

      Skype4Java提供了一个较为完善的开发体系,使您可以非常容易地使用Java

Skype外壳程序。Skype插件程序与Skype的通信都是基于一些文本命令来完

 

   因此,要想开发Skype的插件应用,就需要依靠不同操作系统平台的系统调

用,Skype平台的相应命令来实现。

   

   Skype4Java在最底层,也是通过操作系统的系统调用来完成消息的发送。针对

异构平台,Skype4Java提供了不同平台的底层实现,而Skype4Java的使用者不用

管具体的操作系统平台。因为抽象父类Connector类的静态方法getInstance()具体

判断当前操作系统是什么平台,采用简单的工厂模式,返回相应平台的子类对象,

OSXConnector.LinuxConnector, WindowsConnector, Win32Connector等,这

些都是Connector类的子类。Connector及其子类即实现了一些系统调用的方法,其

中被重载的一系列execute()方法最终调用不同子类的sendCommand (String

command)方法来实现了不同平台的消息发送。

  

    而对于一些数据的接收和处理全局都是采用事件监听的机制(观察者模式),

用于完成数据的接收,处理机制的调用,错误的处理等Skype平台利用错误消息机

制提供了出错的处理。因此,在我们的错误处理中,只需分析错误消息的内容,然

后通过观察者调用相应的处理机制即可。

   

    Skype4Java的实现是按照分层的方法来设计的,分层架构图如下所示。

    

       


Ø         Skype4Java命令发送示例

Skype提供了几种形式的开发接口给不同的语言,但有一个共同点就是,都是通过相同的命令(命令由命令标识符来标识,主要是在确认一个详细的请求命令以及响应消息时用的,每个命令及响应的消息ID是一样的,而且是唯一的),通过这样的方式来操作Skype。对于Skype4Java来说,命令的发送都是通过执行SKYPE4Java的抽象连接层(详细说明见后面),其中有一个核心类Connector的核心方法,原型为protected final String execute(final String command, final String[] responseHeaders, final boolean checkAttached),这个方法体里包含了保证与SKYPE处于连接状态,如果没连接会连接上,并且激发各种事件以及注册对这事件感兴趣的监听器。

public abstract class Connector {

……

protected final String execute(final String command, final String[] responseHeaders, final boolean checkAttached) throws ConnectorException {

    System.out.println("...准备执行命令...");

//先检验这次需要发送的命令,保证不为空

   ConnectorUtils.checkNotNull("command", command);

   ConnectorUtils.checkNotNull("responseHeaders", responseHeaders);

   //输出这次需要发送的命令的有关内容

 System.out.println("command: ->"+command);

        if (checkAttached){

//在发送之前得先保证客户端与Skype Client处于连接状态

          assureAttached();

        }

   //共享锁,因为这是一种请求-响应式的交互,正在执行此命令时要锁住程序专门

//处理这个命令的发送

        final Object lock = new Object();

   //命令的响应

        final String[] response = new String[1];

   //连接监听器的定义

        ConnectorListener listener = new AbstractConnectorListener() {

   //当命令发送后(下面的)完释放锁,客户程序将可以处理接收到的命令响应消

//,查看此命令的执行结果:System.out.println("response:

            public void messageReceived(ConnectorMessageEvent event) {

                String message = event.getMessage();

             System.out.println("response:

                for (String responseHeader : responseHeaders) {

                    if (message.startsWith(responseHeader)) {

                        response[0]=message;

    synchronized (lock) {

                            lock.notify();

                        }

                        return;

                    }

                }

            }

        };

//把上面定义的连接监听器注册到Connector

        addConnectorListener(listener, false);

//每次需要执行一个客户端命令时,都会调用fireMessageSent来激发所有注册进来

//的监听器

        fireMessageSent(command);

//发送命令的过程将会获得共享锁

        synchronized (lock) {

            try {

//调用不同子类的sendCommand方法来实现不同平台的消息发送.

                sendCommand(command);

     //获取发送命令时的当前时间

                long start = System.currentTimeMillis();

//获取命令发送超时的时间

                long commandResponseTime = getCommandTimeout();

//让共享锁锁住这个超时的时间那么长

lock.wait(commandResponseTime);

//判断是否超时

                if (commandResponseTime

                    setStatus(Status.NOT_RUNNING);

                    throw new TimeOutException("The '" + command + "' command failed by timeout.");

                }

            } catch (InterruptedException e) {

                throw new ConnectorException("The '" + command + "' command was interrupted.");

            } finally {

   //移除监听器

                removeConnectorListener(listener);

            }

        }

        return response[0];

}

……

}

      SkypeCommandTest是一个Eclipse下的工程,解压后,直接导入到Eclipse中运行com.skype.test包中的ShowVersion.java类就可以看到命令的发送以及响应,结果为:

 

/*******************************************************************************

 * Copyright (c) 2006 Koji Hisano - UBION Inc. Developer

 * Copyright (c) 2006 UBION Inc. All rights reserved.

 *

 * Copyright (c) 2006 Skype Technologies S.A.

 *

 * This program and the accompanying materials are made available under the

 * terms of the Common Public License v1.0 which accompanies this distribution,

 * and is available at http://www.eclipse.org/legal/cpl-v10.html

 *

 * Contributors: Koji Hisano - initial API and implementation

 ******************************************************************************/

package com.skype.test;

 

import com.skype.Skype;

 

public class ShowVersion {

    public static void main(String[] args) throws Exception {

          

        System.out.println(Skype.getVersion());

    }

}

 

代码中的关键语句是Skype.getVersion()。在这个方法中,首先是发送了”GET SKYPEVERSION”命令,此时并没有连接上Skype。再次发送”NAME SkypeAPI4Java”告知本应用程序的名字,最后发送”PROTOCOL 9999”来获取Skype协议版本,Skype返回版本号,比如:SKYPEVERSION 3.2.4.117

 

Ø         Skype4Java AP2AP示例

如果您需要利用Skype4JAVA开发AP2AP应用时,只需要通过Application对象创建某一个特定名称的应用,然后连接到也创建了此应用的联系人,连接时会返回一个Stream对象,此对象可用于发送基于TCPUDP的文本消息格式,然后通过注册的监听器处理返回消息(此监听器即是应用程序相关的,如您的网络游戏客户端),这样,就实现了通过Skype网络体系的AP2AP应用。

下面通过例子简单介绍一下AP2AP的流程。这段程序向所有的在使用同一Application的联系人发送一条文本消息:"*******HelloWorld!********" 并将对方利用Stream传递回来的文本消息打印到控制台。

 

package com.tom.test;

 

 

import com.skype.Application;

import com.skype.ApplicationAdapter;

import com.skype.Skype;

import com.skype.SkypeException;

import com.skype.Stream;

import com.skype.StreamAdapter;

 

public class AP2APTest {

   public static void main(String[] args) throws Exception {

          Skype.setDebug(true);

          Skype.setDeamon(false);

          //创建特名字的Application,并注册入Skype实例中

          Application application = Skype.addApplication(AP2APTest.class.getName());

          //添加应用监听器,当有相同的应用进行连接时,进行相应的处理

          application.addApplicationListener(new ApplicationAdapter() {

抱歉!评论已关闭.