自学记录：用HarmonyOS API 13实现VoIP通话功能

李游Leo

已于 2025-01-08 23:19:16 修改

阅读量757

点赞数 10

分类专栏： harmonyos 鸿蒙 harmonyos-next 文章标签： harmonyos 华为鸿蒙

于 2024-11-03 10:35:42 首次发布

本文链接：https://blog.youkuaiyun.com/liyou041/article/details/143461944

版权

harmonyos 同时被 3 个专栏收录

34 篇文章

订阅专栏

鸿蒙

33 篇文章

订阅专栏

harmonyos-next

17 篇文章

订阅专栏

今天本来没啥活，我刚弄了杯咖啡咖啡，翻看着技术博客。突然，老板走过来拍了拍我的肩膀，说：“我们有个新需求，你来负责吧。项目里需要一个VoIP通话功能，用最新的HarmonyOS API 13实现，尽快搞定，客户下周要看Demo。”

当时我心里有点慌。之前虽然整过，但是没整过API 13的。但转念一想，这是个好机会，可以学点新东西。于是，我答应了下来，就开始整了。

研究HarmonyOS VoIPCall模块

第一步当然是看文档。根据老板的需求，我找到了华为开发者官网上的VoIPCall模块。这个模块提供了实现VoIP通话的核心能力，包括呼叫发起、接听、挂断等功能。

文档很详尽，但为了理清思路，我总结了几个关键点：

呼叫管理：通过startCall发起呼叫，endCall结束呼叫。
事件监听：通过事件回调监听通话状态。
多方通话：支持管理多个通话会话。
呼叫参数：可以设置音视频通话类型。

这让我对实现功能的基本步骤有了初步的理解。

环境准备：让代码跑起来

在开始开发之前，我确保开发环境已经准备好：

安装DevEco Studio。
配置ArkTS框架。
在项目中添加VoIPCall模块依赖：

npm install @ohos.voipcall

接着，我在代码中引入VoIPCall模块：

import voipCall from '@ohos.voipcall';

第一步：实现呼叫发起

开发的第一步是实现VoIP呼叫的发起功能。根据文档，我们需要调用startCall方法。

代码实现

function initiateCall() {
    const callOptions = {
        number: '+8613800000000', // 被叫号码
        type: voipCall.CallType.AUDIO, // 呼叫类型：音频
    };

    voipCall.startCall(callOptions, {
        success: () => {
            console.info('Call started successfully');
        },
        fail: (err) => {
            console.error(`Failed to start call: ${JSON.stringify(err)}`);
        }
    });
}

initiateCall();

当我运行这段代码时，看到控制台打印出Call started successfully，这让我大大松了一口气，第一步成功了！

文档提到的CallType让我感觉设计得很灵活。可以轻松切换音频和视频通话，为未来扩展功能提供了很好的基础。

第二步：监听通话状态

接下来，我需要实现对通话状态的监听。例如，当被叫方接听时，我需要更新UI。

代码实现

voipCall.on('callStateChange', (state) => {
    switch (state) {
        case voipCall.CallState.ACTIVE:
            console.info('Call is active');
            break;
        case voipCall.CallState.ENDED:
            console.info('Call has ended');
            break;
        default:
            console.warn(`Unhandled state: ${state}`);
    }
});

事件监听的模式让我想起了以前用Node.js处理实时事件的经验。通过这种机制，可以实现对通话全生命周期的精确控制。

第三步：挂断通话

为了完整实现通话功能，我还需要添加挂断功能。

代码实现

function endCall() {
    voipCall.endCall({
        success: () => {
            console.info('Call ended successfully');
        },
        fail: (err) => {
            console.error(`Failed to end call: ${JSON.stringify(err)}`);
        }
    });
}

endCall();

挂断通话是一个简单但重要的功能。开发中我注意到，挂断时需要确保资源释放，避免影响后续操作。

最终成果：VoIP通话Demo

经过两天的开发和调试，我实现了一个简单的VoIP通话Demo，包括以下功能：

用户可以输入电话号码发起呼叫。
通话状态会实时更新，用户可以清晰看到呼叫进程。
用户可以随时挂断通话。

以下是完整的核心代码：

import voipCall from '@ohos.voipcall';

function initiateCall() {
    const callOptions = {
        number: '+8613800000000',
        type: voipCall.CallType.AUDIO,
    };

    voipCall.startCall(callOptions, {
        success: () => {
            console.info('Call started successfully');
        },
        fail: (err) => {
            console.error(`Failed to start call: ${JSON.stringify(err)}`);
        }
    });
}

voipCall.on('callStateChange', (state) => {
    switch (state) {
        case voipCall.CallState.ACTIVE:
            console.info('Call is active');
            break;
        case voipCall.CallState.ENDED:
            console.info('Call has ended');
            break;
        default:
            console.warn(`Unhandled state: ${state}`);
    }
});

function endCall() {
    voipCall.endCall({
        success: () => {
            console.info('Call ended successfully');
        },
        fail: (err) => {
            console.error(`Failed to end call: ${JSON.stringify(err)}`);
        }
    });
}