vchatcloud_flutter_sdk 是一个用于在 Flutter 应用中集成即时通讯功能的插件。通过该插件，开发者可以快速实现聊天、语音、视频等即时通讯功能。以下是如何使用 vchatcloud_flutter_sdk 的基本步骤：

1. 添加依赖

首先，在 pubspec.yaml 文件中添加 vchatcloud_flutter_sdk 依赖：

dependencies:
  flutter:
    sdk: flutter
  vchatcloud_flutter_sdk: ^1.0.0  # 请使用最新版本

然后运行 flutter pub get 来安装依赖。

2. 初始化 SDK

在使用 SDK 之前，需要进行初始化。通常在应用的 main.dart 文件中进行初始化：

import 'package:flutter/material.dart';
import 'package:vchatcloud_flutter_sdk/vchatcloud_flutter_sdk.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  // 初始化 SDK
  await VChatCloudFlutterSdk.init(
    appId: 'YOUR_APP_ID',
    appKey: 'YOUR_APP_KEY',
  );
  
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'VChatCloud Demo',
      home: ChatScreen(),
    );
  }
}

3. 登录用户

在初始化 SDK 之后，需要登录用户才能使用即时通讯功能。登录通常需要提供用户的唯一标识符（如用户 ID 或用户名）：

import 'package:vchatcloud_flutter_sdk/vchatcloud_flutter_sdk.dart';

void loginUser() async {
  try {
    await VChatCloudFlutterSdk.login(
      userId: 'USER_ID',
      userName: 'USER_NAME',
      token: 'USER_TOKEN', // 如果需要的话
    );
    print('登录成功');
  } catch (e) {
    print('登录失败: $e');
  }
}

4. 发送消息

登录成功后，可以使用 SDK 提供的 API 发送消息：

import 'package:vchatcloud_flutter_sdk/vchatcloud_flutter_sdk.dart';

void sendMessage() async {
  try {
    await VChatCloudFlutterSdk.sendMessage(
      toUserId: 'RECEIVER_USER_ID',
      message: 'Hello, World!',
    );
    print('消息发送成功');
  } catch (e) {
    print('消息发送失败: $e');
  }
}

5. 接收消息

为了接收消息，需要设置消息监听器：

import 'package:vchatcloud_flutter_sdk/vchatcloud_flutter_sdk.dart';

void setMessageListener() {
  VChatCloudFlutterSdk.setOnMessageReceivedListener((message) {
    print('收到新消息: ${message.content}');
    // 处理收到的消息
  });
}

6. 加入聊天室

如果需要加入聊天室，可以使用以下代码：

import 'package:vchatcloud_flutter_sdk/vchatcloud_flutter_sdk.dart';

void joinChatRoom() async {
  try {
    await VChatCloudFlutterSdk.joinChatRoom(
      roomId: 'ROOM_ID',
    );
    print('加入聊天室成功');
  } catch (e) {
    print('加入聊天室失败: $e');
  }
}

7. 发送语音/视频

如果 SDK 支持语音或视频通话，可以使用以下代码发起通话：

import 'package:vchatcloud_flutter_sdk/vchatcloud_flutter_sdk.dart';

void startCall() async {
  try {
    await VChatCloudFlutterSdk.startCall(
      toUserId: 'RECEIVER_USER_ID',
      callType: CallType.video, // 或 CallType.audio
    );
    print('通话发起成功');
  } catch (e) {
    print('通话发起失败: $e');
  }
}

8. 处理通话事件

为了处理通话事件，可以设置通话状态监听器：

import 'package:vchatcloud_flutter_sdk/vchatcloud_flutter_sdk.dart';

void setCallListener() {
  VChatCloudFlutterSdk.setOnCallStateChangedListener((callState) {
    print('通话状态变化: $callState');
    // 处理通话状态变化
  });
}

9. 退出登录

在用户退出应用时，建议调用退出登录方法：

import 'package:vchatcloud_flutter_sdk/vchatcloud_flutter_sdk.dart';

void logout() async {
  try {
    await VChatCloudFlutterSdk.logout();
    print('退出登录成功');
  } catch (e) {
    print('退出登录失败: $e');
  }
}

10. 错误处理

在使用 SDK 的过程中，可能会遇到各种错误。建议在调用 SDK 方法时进行错误处理，以确保应用的稳定性。

try {
  // 调用 SDK 方法
} catch (e) {
  print('发生错误: $e');
}