diff --git a/zh-cn/application-dev/reference/apis/js-apis-call.md b/zh-cn/application-dev/reference/apis/js-apis-call.md index 5af34a15bcaca50c5bd7821b3c9944bef3892b78..63497a1ada0e5502ebdf906138e7c7a84fd4df15 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-call.md +++ b/zh-cn/application-dev/reference/apis/js-apis-call.md @@ -1719,6 +1719,91 @@ call.combineConference(1).then(() => { }); ``` +## call.kickOutFromConference10+ + +kickOutFromConference\(callId: number, callback: AsyncCallback\\): void + +踢出电话会议,将指定通话从会议电话中挂断。使用callback异步回调。 + +**系统接口:** 此接口为系统接口。 + +**需要权限**:ohos.permission.PLACE_CALL + +**系统能力**:SystemCapability.Telephony.CallManager + +**参数:** + +| 参数名 | 类型 | 必填 | 说明 | +| -------- | ------------------------- | ---- | ---------- | +| callId | number | 是 | 呼叫Id。 | +| callback | AsyncCallback<void> | 是 | 回调函数。 | + +**错误码:** + +以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 + +| 错误码ID | 错误信息 | +| -------- | -------------------------------------------- | +| 202 | Non-system applications use system APIs. | +| 401 | Parameter error. | +| 8300001 | Invalid parameter value. | +| 8300002 | Operation failed. Cannot connect to service. | +| 8300003 | System internal error. | + +**示例:** + +```js +call.kickOutFromConference(1, (err) => { + console.log(`callback: err->${JSON.stringify(err)}`); +}); +``` + +## call.kickOutFromConference10+ + +kickOutFromConference\(callId: number\): Promise\ + +踢出电话会议,将指定通话从会议电话中挂断。使用Promise异步回调。 + +**系统接口:** 此接口为系统接口。 + +**需要权限**:ohos.permission.PLACE_CALL + +**系统能力**:SystemCapability.Telephony.CallManager + +**参数:** + +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ------ | ---- | -------- | +| callId | number | 是 | 呼叫Id。 | + +**返回值:** + +| 类型 | 说明 | +| ------------------- | --------------------------- | +| Promise<void> | 以Promise形式异步返回结果。 | + +**错误码:** + +以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 + +| 错误码ID | 错误信息 | +| -------- | -------------------------------------------- | +| 202 | Non-system applications use system APIs. | +| 401 | Parameter error. | +| 8300001 | Invalid parameter value. | +| 8300002 | Operation failed. Cannot connect to service. | +| 8300003 | System internal error. | + +**示例:** + +```js +call.kickOutFromConference(1).then(() => { + console.log(`kickOutFromConference success.`); +}).catch((err) => { + console.error(`kickOutFromConference fail, promise: err->${JSON.stringify(err)}`); +}); +``` + ## call.getMainCallId7+ getMainCallId\(callId: number, callback: AsyncCallback\\): void @@ -1998,6 +2083,7 @@ getCallWaitingStatus\(slotId: number, callback: AsyncCallback\ | 201 | Permission denied. | | 202 | Non-system applications use system APIs. | | 401 | Parameter error. | +| 801 | Capability not supported. | | 8300001 | Invalid parameter value. | | 8300002 | Operation failed. Cannot connect to service. | | 8300003 | System internal error. | @@ -2088,6 +2175,7 @@ setCallWaiting\(slotId: number, activate: boolean, callback: AsyncCallback\ | 201 | Permission denied. | | 202 | Non-system applications use system APIs. | | 401 | Parameter error. | +| 801 | Capability not supported. | | 8300001 | Invalid parameter value. | | 8300002 | Operation failed. Cannot connect to service. | | 8300003 | System internal error. | @@ -2999,6 +3088,7 @@ getCallRestrictionStatus\(slotId: number, type: CallRestrictionType, callback: A | 201 | Permission denied. | | 202 | Non-system applications use system APIs. | | 401 | Parameter error. | +| 801 | Capability not supported. | | 8300001 | Invalid parameter value. | | 8300002 | Operation failed. Cannot connect to service. | | 8300003 | System internal error. | @@ -3046,6 +3136,7 @@ getCallRestrictionStatus\(slotId: number, type: CallRestrictionType\): Promise\< | 201 | Permission denied. | | 202 | Non-system applications use system APIs. | | 401 | Parameter error. | +| 801 | Capability not supported. | | 8300001 | Invalid parameter value. | | 8300002 | Operation failed. Cannot connect to service. | | 8300003 | System internal error. | @@ -3090,6 +3181,7 @@ setCallRestriction\(slotId: number, info: CallRestrictionInfo, callback: AsyncCa | 201 | Permission denied. | | 202 | Non-system applications use system APIs. | | 401 | Parameter error. | +| 801 | Capability not supported. | | 8300001 | Invalid parameter value. | | 8300002 | Operation failed. Cannot connect to service. | | 8300003 | System internal error. | @@ -3142,6 +3234,7 @@ setCallRestriction\(slotId: number, info: CallRestrictionInfo\): Promise\ | 201 | Permission denied. | | 202 | Non-system applications use system APIs. | | 401 | Parameter error. | +| 801 | Capability not supported. | | 8300001 | Invalid parameter value. | | 8300002 | Operation failed. Cannot connect to service. | | 8300003 | System internal error. | @@ -3161,6 +3254,99 @@ call.setCallRestriction(0, callRestrictionInfo).then(() => { }); ``` +## call.setCallRestrictionPassword10+ + +setCallRestrictionPassword\(slotId: number, oldPassword: string, newPassword: string, callback: AsyncCallback\\): void + +设置呼叫限制密码。使用callback异步回调。 + +**系统接口:** 此接口为系统接口。 + +**需要权限**:ohos.permission.SET_TELEPHONY_STATE + +**系统能力**:SystemCapability.Telephony.CallManager + +**参数:** + +| 参数名 | 类型 | 必填 | 说明 | +| --------------- | ------------------------------------------- | ---- | ------------------------------------ | +| slotId | number | 是 | 卡槽ID。
- 0:卡槽1
- 1:卡槽2 | +| oldPassword | string | 是 | 呼叫限制旧密码。 | +| newPassword | string | 是 | 呼叫限制新密码。 | +| callback | AsyncCallback<void> | 是 | 回调函数。 | + +**错误码:** + +以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 + +| 错误码ID | 错误信息 | +| -------- | -------------------------------------------- | +| 201 | Permission denied. | +| 202 | Non-system applications use system APIs. | +| 401 | Parameter error. | +| 801 | Capability not supported. | +| 8300001 | Invalid parameter value. | +| 8300002 | Operation failed. Cannot connect to service. | +| 8300003 | System internal error. | + +**示例:** + +```js +call.setCallRestrictionPassword(0, "123456", "654321", (err) => { + console.log(`callback: err->${JSON.stringify(err)}`); +}); +``` + +## call.setCallRestrictionPassword10+ + +setCallRestrictionPassword\(slotId: number, oldPassword: string, newPassword: string\): Promise\ + +设置呼叫限制密码。使用Promise异步回调。 + +**系统接口:** 此接口为系统接口。 + +**需要权限**:ohos.permission.SET_TELEPHONY_STATE + +**系统能力**:SystemCapability.Telephony.CallManager + +**参数:** + +| 参数名 | 类型 | 必填 | 说明 | +| --------------- | ------------------------------------------- | ---- | ------------------------------------ | +| slotId | number | 是 | 卡槽ID。
- 0:卡槽1
- 1:卡槽2 | +| oldPassword | string | 是 | 呼叫限制旧密码。 | +| newPassword | string | 是 | 呼叫限制新密码。 | + +**返回值:** + +| 类型 | 说明 | +| ------------------- | --------------------------- | +| Promise<void> | 以Promise形式异步返回结果。 | + +**错误码:** + +以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 + +| 错误码ID | 错误信息 | +| -------- | -------------------------------------------- | +| 201 | Permission denied. | +| 202 | Non-system applications use system APIs. | +| 401 | Parameter error. | +| 801 | Capability not supported. | +| 8300001 | Invalid parameter value. | +| 8300002 | Operation failed. Cannot connect to service. | +| 8300003 | System internal error. | + +**示例:** + +```js +call.setCallRestrictionPassword(0, "123456", "654321").then(() => { + console.log(`setCallRestrictionPassword success.`); +}).catch((err) => { + console.error(`setCallRestrictionPassword fail, promise: err->${JSON.stringify(err)}`); +}); +``` + ## call.getCallTransferInfo8+ getCallTransferInfo\(slotId: number, type: CallTransferType, callback: AsyncCallback\\): void @@ -3190,6 +3376,7 @@ getCallTransferInfo\(slotId: number, type: CallTransferType, callback: AsyncCall | 201 | Permission denied. | | 202 | Non-system applications use system APIs. | | 401 | Parameter error. | +| 801 | Capability not supported. | | 8300001 | Invalid parameter value. | | 8300002 | Operation failed. Cannot connect to service. | | 8300003 | System internal error. | @@ -3237,6 +3424,7 @@ getCallTransferInfo\(slotId: number, type: CallTransferType\): Promise\ | 201 | Permission denied. | | 202 | Non-system applications use system APIs. | | 401 | Parameter error. | +| 801 | Capability not supported. | | 8300001 | Invalid parameter value. | | 8300002 | Operation failed. Cannot connect to service. | | 8300003 | System internal error. |