技术文档：webrtc-jingle 项目使用与安装指南

1. 安装指南

安装依赖

• 首先安装 depot_tools，用于检出项目。

• 创建项目目录，并使用 gclient 命令检出代码：

  mkdir webrtcjingleproject
  cd webrtcjingleproject
  gclient config https://github.com/lukeweber/webrtc-jingle-client.git --name trunk
  gclient sync
  

• 对于需要稳定版本的用户，可以使用以下命令检出稳定版本的代码：

  gclient sync --revision PUT_STABLE_HEAD_REV_HERE
  

安装Android依赖

• 安装Android NDK (r8e版本) 和 Android SDK。

• 安装eclipse和Maven (v3.0.3+)。

• 将以下环境变量添加到 .bashrc 或 .bash_profile：

  export ANDROID_SDK_ROOT=/path/to/sdk/
  export ANDROID_NDK_ROOT=/path/to/ndk/
  export PATH=$PATH:$ANDROID_NDK_ROOT:$ANDROID_SDK_ROOT:$ANDROID_SDK_ROOT/platform-tools
  
  export ANDROID_HOME=$ANDROID_SDK_ROOT
  export ANDROID_NDK_HOME=$ANDROID_NDK_ROOT
  

安装iOS依赖

• 准备一台装有最新Xcode和命令行工具的Mac机器。

2. 项目的使用说明

Android使用

• 构建并部署到手机，并启动调试器：运行 tools/badit_android.py 脚本。
• 构建APK文件：cd trunk/android && mvn install。
• 运行调试器：build/android/gdb_apk -p com.tuenti.voice.example -s VoiceClientService -l android/voice-client-native/obj/${build_profile}/local/${app_abi}。
• 也可以使用一个轻量级的shell包装器来编译仅C++项目。

iOS使用

• 对 third_party/expat 应用水印补丁。
• 修改 .gclient 文件，添加目标操作系统为iOS。
• 再次运行 gclient sync 来获取 xmppframework。
• 使用 gyp 自动生成Xcode项目，并打开。
• 在 AppDelegate.mm 中修改 myJID 和 myPassword。
• 在 ViewController.mm 中修改要呼叫的用户。
• 如果使用Xmpp服务器，确保在 login 中更改 isGtalk 标志。
• 在Xcode中构建并部署。

3. 项目API使用文档

由于项目是基于libjingle和webrtc的，API使用主要涉及这两部分的调用。具体API使用文档需要参照libjingle和webrtc的官方文档。这里只提供一些基本的API使用示例。

Android API示例

// 初始化Jingle客户端
JingleClient client = new JingleClient(context);

// 设置连接状态监听器
client.setConnectionListener(new JingleConnectionListener() {
    @Override
    public void onConnected() {
        // 连接成功
    }

    @Override
    public void onDisconnected() {
        // 连接断开
    }
});

// 开始连接
client.connect();

iOS API示例

// 初始化Jingle客户端
JingleClient *client = [[JingleClient alloc] initWithContext:context];

// 设置连接状态监听器
[client setConnectionListener:self];

// 开始连接
[client connect];

4. 项目安装方式

项目的安装方式已在“安装指南”中详细描述，这里不再赘述。

请确保按照以上指南正确安装依赖和项目，以便顺利进行开发和使用。