HarmonyOS 鸿蒙Next中Telephony Kit（蜂窝通信服务）的observer.off('callStateChangeEx')参数类型异常

HarmonyOS 鸿蒙Next中Telephony Kit（蜂窝通信服务）的observer.off(‘callStateChangeEx’)参数类型异常 【问题描述】：在鸿蒙开发者官网文档中，Telephony Kit（蜂窝通信服务）的observer.off(‘callStateChangeEx’)第二个参数类型为Callback<TelCallState>，此处与SDK中的类型一致。但在实际开发中发现，此处callback返回的真实类型为对象，并非枚举。

【问题现象】：获取到observer.off(‘callStateChangeEx’) Callback的监听内容为对象，与预期的枚举类型不符。 cke_40718.png cke_43491.png

【版本信息】：

DevEco Studio：DevEco Studio 6.0.2.640

SDK：6.0.2.130 (API Version 22 Release)

运行设备：ALN-AL00 6.0.0.130(SP25C00E130R4P12patch01)

【复现代码】：

import { observer } from '@kit.TelephonyKit';

@Entry
@Component
struct Index {
  build() {
    Button('callStateChangeEx')
      .onClick(() => {
        observer.on('callStateChangeEx', (data) => {
          // data 预期值为 0，实际值为 { state: 0 }
          console.log('callStateChangeEx---' + JSON.stringify(data))
        });
      })
  }
}

【尝试解决方案】：本地定义该参数正确的数据类型临时使用


更多关于HarmonyOS 鸿蒙Next中Telephony Kit（蜂窝通信服务）的observer.off('callStateChangeEx')参数类型异常的实战教程也可以访问 https://www.itying.com/category-93-b0.html

4 回复

尊敬的开发者，您好！感谢您的反馈，问题正在加速处理中，还请关注后续版本，感谢您的理解与支持。

更多关于HarmonyOS 鸿蒙Next中Telephony Kit（蜂窝通信服务）的observer.off('callStateChangeEx')参数类型异常的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


赞，

在HarmonyOS Next中，Telephony Kit的observer.off('callStateChangeEx')方法要求传入一个CallStateObserver对象作为参数，用于取消之前通过observer.on('callStateChangeEx')注册的对应监听器。如果传入的参数类型不是有效的CallStateObserver实例，就会触发参数类型异常。

根据您提供的代码和截图，您遇到的问题确实是Telephony Kit中observer.on('callStateChangeEx')回调参数类型与API文档声明不符。

问题分析：

  1. 文档声明：API文档和SDK类型定义（Callback<TelCallState>）表明，回调参数data应为TelCallState枚举值（例如0代表CALL_STATE_IDLE）。
  2. 实际运行：从您的日志输出 { state: 0 } 可以看出，运行时实际回调的是一个对象，该对象包含一个state属性，其值才是预期的TelCallState枚举值。

结论： 这是当前SDK（6.0.2.130）实现与类型定义/文档之间存在的一个不一致问题。回调的实际数据结构是 { state: TelCallState }，而非直接的 TelCallState。

临时解决方案： 您采取的方案——在本地根据实际结构定义类型并访问state属性——是目前唯一可行的正确方法。例如：

observer.on('callStateChangeEx', (data: { state: call.TelCallState }) => {
  console.log('callStateChangeEx state---' + data.state);
  // 根据 data.state 进行业务逻辑判断
});

后续处理： 此类接口定义与实现不一致的问题，通常会在后续的SDK版本中修复。建议关注HarmonyOS的官方更新日志。在修复后，接口行为会与文档保持一致，届时您需要移除对state属性的访问，直接使用回调参数。

回到顶部