tencent_cloud_chat_contact 是腾讯云提供的 Flutter 插件，用于管理腾讯云 IM（即时通讯）的联系人功能。通过该插件，开发者可以方便地在 Flutter 应用中实现添加、删除、查询联系人等操作。

以下是如何在 Flutter 项目中使用 tencent_cloud_chat_contact 插件的详细步骤：

1. 添加依赖

首先，在 pubspec.yaml 文件中添加 tencent_cloud_chat_contact 插件的依赖：

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

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

2. 初始化插件

在使用插件之前，需要先初始化腾讯云 IM 的 SDK。这通常在应用的 main.dart 文件中完成。

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

void main() async {
  WidgetsFlutterBinding.ensureInitialized();

  // 初始化腾讯云IM SDK
  await TencentCloudChatContact.initSDK(sdkAppId: 'your_sdk_app_id');

  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: MyHomePage(),
    );
  }
}

3. 登录腾讯云 IM

在使用联系人管理功能之前，需要先登录腾讯云 IM。

import 'package:tencent_cloud_chat_contact/tencent_cloud_chat_contact.dart';

Future<void> login() async {
  await TencentCloudChatContact.login(
    userId: 'your_user_id',
    userSig: 'your_user_sig',
  );
}

4. 添加联系人

你可以使用 addContact 方法来添加联系人。

import 'package:tencent_cloud_chat_contact/tencent_cloud_chat_contact.dart';

Future<void> addContact() async {
  await TencentCloudChatContact.addContact(
    userId: 'contact_user_id',
    remark: 'Friend',
    addType: AddType.Both,
  );
}

5. 删除联系人

你可以使用 deleteContact 方法来删除联系人。

import 'package:tencent_cloud_chat_contact/tencent_cloud_chat_contact.dart';

Future<void> deleteContact() async {
  await TencentCloudChatContact.deleteContact(
    userId: 'contact_user_id',
    deleteType: DeleteType.Both,
  );
}

6. 查询联系人列表

你可以使用 getContactList 方法来获取联系人列表。

import 'package:tencent_cloud_chat_contact/tencent_cloud_chat_contact.dart';

Future<void> getContactList() async {
  List<ContactInfo> contactList = await TencentCloudChatContact.getContactList();
  for (var contact in contactList) {
    print('Contact ID: ${contact.userId}, Remark: ${contact.remark}');
  }
}

7. 监听联系人事件

你可以监听联系人相关的事件，例如联系人添加、删除等。

import 'package:tencent_cloud_chat_contact/tencent_cloud_chat_contact.dart';

void listenContactEvents() {
  TencentCloudChatContact.onContactAdded.listen((contact) {
    print('New contact added: ${contact.userId}');
  });

  TencentCloudChatContact.onContactDeleted.listen((contact) {
    print('Contact deleted: ${contact.userId}');
  });
}

8. 处理异常

在使用插件时，建议处理可能出现的异常。

import 'package:tencent_cloud_chat_contact/tencent_cloud_chat_contact.dart';

Future<void> safeAddContact() async {
  try {
    await TencentCloudChatContact.addContact(
      userId: 'contact_user_id',
      remark: 'Friend',
      addType: AddType.Both,
    );
  } catch (e) {
    print('Failed to add contact: $e');
  }
}

9. 退出登录

在应用退出时，建议调用 logout 方法退出登录。

import 'package:tencent_cloud_chat_contact/tencent_cloud_chat_contact.dart';

Future<void> logout() async {
  await TencentCloudChatContact.logout();
}

10. 销毁 SDK

在应用关闭时，可以调用 destroy 方法来释放资源。

import 'package:tencent_cloud_chat_contact/tencent_cloud_chat_contact.dart';

Future<void> destroySDK() async {
  await TencentCloudChatContact.destroy();
}

完整示例

以下是一个简单的 Flutter 应用示例，演示了如何使用 tencent_cloud_chat_contact 插件进行联系人管理：

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

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await TencentCloudChatContact.initSDK(sdkAppId: 'your_sdk_app_id');
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: MyHomePage(),
    );
  }
}

class MyHomePage extends StatefulWidget {
  [@override](/user/override)
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  [@override](/user/override)
  void initState() {
    super.initState();
    login();
    listenContactEvents();
  }

  Future<void> login() async {
    await TencentCloudChatContact.login(
      userId: 'your_user_id',
      userSig: 'your_user_sig',
    );
  }

  void listenContactEvents() {
    TencentCloudChatContact.onContactAdded.listen((contact) {
      print('New contact added: ${contact.userId}');
    });

    TencentCloudChatContact.onContactDeleted.listen((contact) {
      print('Contact deleted: ${contact.userId}');
    });
  }

  Future<void> addContact() async {
    try {
      await TencentCloudChatContact.addContact(
        userId: 'contact_user_id',
        remark: 'Friend',
        addType: AddType.Both,
      );
    } catch (e) {
      print('Failed to add contact: $e');
    }
  }

  Future<void> deleteContact() async {
    try {
      await TencentCloudChatContact.deleteContact(
        userId: 'contact_user_id',
        deleteType: DeleteType.Both,
      );
    } catch (e) {
      print('Failed to delete contact: $e');
    }
  }

  Future<void> getContactList() async {
    List<ContactInfo> contactList = await TencentCloudChatContact.getContactList();
    for (var contact in contactList) {
      print('Contact ID: ${contact.userId}, Remark: ${contact.remark}');
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Tencent Cloud Chat Contact Demo'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            ElevatedButton(
              onPressed: addContact,
              child: Text('Add Contact'),
            ),
            ElevatedButton(
              onPressed: deleteContact,
              child: Text('Delete Contact'),
            ),
            ElevatedButton(
              onPressed: getContactList,
              child: Text('Get Contact List'),
            ),
          ],
        ),
      ),
    );
  }
}