W3Cschool
恭喜您成為首批注冊用戶
獲得88經(jīng)驗值獎勵
本模塊提供訂閱管理功能,可以訂閱/取消訂閱的事件包括:網(wǎng)絡狀態(tài)變化、信號狀態(tài)變化、通話狀態(tài)變化、蜂窩數(shù)據(jù)鏈路連接狀態(tài)、蜂窩數(shù)據(jù)業(yè)務的上下行數(shù)據(jù)流狀態(tài)、SIM狀態(tài)變化。
本模塊首批接口從API version 6開始支持。后續(xù)版本的新增接口,采用上角標單獨標記接口的起始版本。
on(type: 'networkStateChange', callback: Callback<NetworkState>): void;
訂閱網(wǎng)絡狀態(tài)變化事件,使用callback方式作為異步方法。
需要權(quán)限:ohos.permission.GET_NETWORK_INFO
系統(tǒng)能力:SystemCapability.Telephony.StateRegistry
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
type | string | 是 | 網(wǎng)絡狀態(tài)變化事件,參數(shù)固定為'networkStateChange'。 |
callback | Callback<NetworkState> | 是 | 回調(diào)函數(shù)。參考radio的NetworkState |
錯誤碼:
以下錯誤碼的詳細介紹請參見ohos.telephony(電話子系統(tǒng))錯誤碼錯誤碼。
錯誤碼ID | 錯誤信息 |
---|---|
201 | Permission denied. |
401 | Parameter error. |
8300001 | Invalid parameter value. |
8300002 | Operation failed. Cannot connect to service. |
8300003 | System internal error. |
8300999 | Unknown error code. |
示例:
- observer.on('networkStateChange', data => {
- console.log("on networkStateChange, data:" + JSON.stringify(data));
- });
on(type: 'networkStateChange', options: { slotId: number }, callback: Callback<NetworkState>): void;
訂閱指定卡槽位的網(wǎng)絡狀態(tài)變化事件,使用callback方式作為異步方法。
需要權(quán)限:ohos.permission.GET_NETWORK_INFO
系統(tǒng)能力:SystemCapability.Telephony.StateRegistry
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
type | string | 是 | 網(wǎng)絡狀態(tài)變化事件,參數(shù)固定為'networkStateChange'。 |
slotId | number | 是 | 卡槽ID。 - 0:卡槽1 - 1:卡槽2 |
callback | Callback<NetworkState> | 是 | 回調(diào)函數(shù)。參考radio的NetworkState |
錯誤碼:
以下錯誤碼的詳細介紹請參見ohos.telephony(電話子系統(tǒng))錯誤碼錯誤碼。
錯誤碼ID | 錯誤信息 |
---|---|
201 | Permission denied. |
401 | Parameter error. |
8300001 | Invalid parameter value. |
8300002 | Operation failed. Cannot connect to service. |
8300003 | System internal error. |
8300999 | Unknown error code. |
示例:
- observer.on('networkStateChange', {slotId: 0}, data => {
- console.log("on networkStateChange, data:" + JSON.stringify(data));
- });
off(type: 'networkStateChange', callback?: Callback<NetworkState>): void;
取消訂閱網(wǎng)絡狀態(tài)變化事件,使用callback方式作為異步方法。
可以指定傳入on中的callback取消一個訂閱,也可以不指定callback清空所有訂閱。
系統(tǒng)能力:SystemCapability.Telephony.StateRegistry
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
type | string | 是 | 網(wǎng)絡狀態(tài)變化事件,參數(shù)固定為'networkStateChange'。 |
callback | Callback<NetworkState> | 否 | 回調(diào)函數(shù)。參考radio的NetworkState |
錯誤碼ID | 錯誤信息 |
---|---|
401 | Parameter error. |
8300001 | Invalid parameter value. |
8300002 | Operation failed. Cannot connect to service. |
8300003 | System internal error. |
8300999 | Unknown error code. |
示例:
- let callback = data => {
- console.log("on networkStateChange, data:" + JSON.stringify(data));
- }
- observer.on('networkStateChange', callback);
- // 可以指定傳入on中的callback取消一個訂閱,也可以不指定callback清空所有訂閱。
- observer.off('networkStateChange', callback);
- observer.off('networkStateChange');
on(type: 'signalInfoChange', callback: Callback<Array<SignalInformation>>): void;
訂閱信號狀態(tài)變化事件,使用callback方式作為異步方法。
系統(tǒng)能力:SystemCapability.Telephony.StateRegistry
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
type | string | 是 | 信號狀態(tài)變化事件,參數(shù)固定為'signalInfoChange'。 |
callback | Callback<Array<SignalInformation>> | 是 | 回調(diào)函數(shù)。參考radio的SignalInformation |
錯誤碼:
以下錯誤碼的詳細介紹請參見ohos.telephony(電話子系統(tǒng))錯誤碼錯誤碼。
錯誤碼ID | 錯誤信息 |
---|---|
201 | Permission denied. |
401 | Parameter error. |
8300001 | Invalid parameter value. |
8300002 | Operation failed. Cannot connect to service. |
8300003 | System internal error. |
8300999 | Unknown error code. |
示例:
- observer.on('signalInfoChange', data => {
- console.log("on signalInfoChange, data:" + JSON.stringify(data));
- });
on(type: 'signalInfoChange', options: { slotId: number }, callback: Callback<Array<SignalInformation>>): void;
訂閱指定卡槽位的信號狀態(tài)變化事件,使用callback方式作為異步方法。
系統(tǒng)能力:SystemCapability.Telephony.StateRegistry
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
type | string | 是 | 信號狀態(tài)變化事件,參數(shù)固定為'signalInfoChange'。 |
slotId | number | 是 | 卡槽ID。 - 0:卡槽1 - 1:卡槽2 |
callback | Callback<Array<SignalInformation>> | 是 | 回調(diào)函數(shù)。參考radio的SignalInformation |
錯誤碼:
以下錯誤碼的詳細介紹請參見ohos.telephony(電話子系統(tǒng))錯誤碼錯誤碼。
錯誤碼ID | 錯誤信息 |
---|---|
201 | Permission denied. |
401 | Parameter error. |
8300001 | Invalid parameter value. |
8300002 | Operation failed. Cannot connect to service. |
8300003 | System internal error. |
8300999 | Unknown error code. |
示例:
- observer.on('signalInfoChange', {slotId: 0}, data => {
- console.log("on signalInfoChange, data:" + JSON.stringify(data));
- });
off(type: 'signalInfoChange', callback?: Callback<Array<SignalInformation>>): void;
取消訂閱信號狀態(tài)變化事件,使用callback方式作為異步方法。
可以指定傳入on中的callback取消一個訂閱,也可以不指定callback清空所有訂閱。
系統(tǒng)能力:SystemCapability.Telephony.StateRegistry
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
type | string | 是 | 信號狀態(tài)變化事件,參數(shù)固定為'signalInfoChange'。 |
callback | Callback<Array<SignalInformation>> | 否 | 回調(diào)函數(shù)。參考radio的SignalInformation |
錯誤碼:
以下錯誤碼的詳細介紹請參見ohos.telephony(電話子系統(tǒng))錯誤碼錯誤碼。
錯誤碼ID | 錯誤信息 |
---|---|
401 | Parameter error. |
8300001 | Invalid parameter value. |
8300002 | Operation failed. Cannot connect to service. |
8300003 | System internal error. |
8300999 | Unknown error code. |
示例:
- let callback = data => {
- console.log("on signalInfoChange, data:" + JSON.stringify(data));
- }
- observer.on('signalInfoChange', callback);
- // 可以指定傳入on中的callback取消一個訂閱,也可以不指定callback清空所有訂閱。
- observer.off('signalInfoChange', callback);
- observer.off('signalInfoChange');
on(type: 'callStateChange', callback: Callback<{ state: CallState, number: string }>): void;
訂閱通話狀態(tài)變化事件,使用callback方式作為異步方法。
系統(tǒng)能力:SystemCapability.Telephony.StateRegistry
參數(shù):
錯誤碼:
以下錯誤碼的詳細介紹請參見ohos.telephony(電話子系統(tǒng))錯誤碼錯誤碼。
錯誤碼ID | 錯誤信息 |
---|---|
401 | Parameter error. |
8300001 | Invalid parameter value. |
8300002 | Operation failed. Cannot connect to service. |
8300003 | System internal error. |
8300999 | Unknown error code. |
示例:
- observer.on('callStateChange', value => {
- console.log("on callStateChange, state:" + value.state + ", number:" + value.number);
- });
on(type: 'callStateChange', options: { slotId: number }, callback: Callback<{ state:CallState, number: string }>): void;
訂閱通話狀態(tài)變化事件,使用callback方式作為異步方法。
系統(tǒng)能力:SystemCapability.Telephony.StateRegistry
參數(shù):
錯誤碼:
以下錯誤碼的詳細介紹請參見ohos.telephony(電話子系統(tǒng))錯誤碼錯誤碼。
錯誤碼ID | 錯誤信息 |
---|---|
401 | Parameter error. |
8300001 | Invalid parameter value. |
8300002 | Operation failed. Cannot connect to service. |
8300003 | System internal error. |
8300999 | Unknown error code. |
示例:
- observer.on('callStateChange', {slotId: 0}, value => {
- console.log("on callStateChange, state:" + value.state + ", number:" + value.number);
- });
off(type: 'callStateChange', callback?: Callback<{ state: CallState, number: string }>): void;
取消訂閱通話狀態(tài)變化事件,使用callback方式作為異步方法。
可以指定傳入on中的callback取消一個訂閱,也可以不指定callback清空所有訂閱。
系統(tǒng)能力:SystemCapability.Telephony.StateRegistry
參數(shù):
錯誤碼:
以下錯誤碼的詳細介紹請參見ohos.telephony(電話子系統(tǒng))錯誤碼錯誤碼。
錯誤碼ID | 錯誤信息 |
---|---|
401 | Parameter error. |
8300001 | Invalid parameter value. |
8300002 | Operation failed. Cannot connect to service. |
8300003 | System internal error. |
8300999 | Unknown error code. |
示例:
- let callback = value => {
- console.log("on callStateChange, state:" + value.state + ", number:" + value.number);
- }
- observer.on('callStateChange', callback);
- // 可以指定傳入on中的callback取消一個訂閱,也可以不指定callback清空所有訂閱。
- observer.off('callStateChange', callback);
- observer.off('callStateChange');
on(type: 'cellularDataConnectionStateChange', callback: Callback<{ state: DataConnectState, network: RatType}>): void;
訂閱蜂窩數(shù)據(jù)鏈路連接狀態(tài),使用callback方式作為異步方法。
系統(tǒng)能力:SystemCapability.Telephony.StateRegistry
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
type | string | 是 | 蜂窩數(shù)據(jù)鏈路連接狀態(tài)事件,參數(shù)固定為'cellularDataConnectionStateChange'。 |
callback | Callback<{ state: DataConnectState, network: RatType }> | 是 | 回調(diào)函數(shù),參考data的DataConnectState,radio的RadioTechnology。 |
錯誤碼:
以下錯誤碼的詳細介紹請參見ohos.telephony(電話子系統(tǒng))錯誤碼錯誤碼。
錯誤碼ID | 錯誤信息 |
---|---|
401 | Parameter error. |
8300001 | Invalid parameter value. |
8300002 | Operation failed. Cannot connect to service. |
8300003 | System internal error. |
8300999 | Unknown error code. |
示例:
- observer.on('cellularDataConnectionStateChange', value => {
- console.log("on cellularDataConnectionStateChange, state:" + value.state + ", network:" + value.network);
- });
on(type: 'cellularDataConnectionStateChange', options: { slotId: number }, callback: Callback<{ state: DataConnectState, network: RatType }>): void;
訂閱指定卡槽位的蜂窩數(shù)據(jù)鏈路連接狀態(tài),使用callback方式作為異步方法。
系統(tǒng)能力:SystemCapability.Telephony.StateRegistry
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
type | string | 是 | 蜂窩數(shù)據(jù)鏈路連接狀態(tài)事件,參數(shù)固定為'cellularDataConnectionStateChange'。 |
slotId | number | 是 | 卡槽ID。 - 0:卡槽1 - 1:卡槽2 |
callback | Callback<{ state: DataConnectState, network: RatType }> | 是 | 回調(diào)函數(shù),參考data的DataConnectState,radio的RadioTechnology。 |
錯誤碼:
以下錯誤碼的詳細介紹請參見ohos.telephony(電話子系統(tǒng))錯誤碼錯誤碼。
錯誤碼ID | 錯誤信息 |
---|---|
401 | Parameter error. |
8300001 | Invalid parameter value. |
8300002 | Operation failed. Cannot connect to service. |
8300003 | System internal error. |
8300999 | Unknown error code. |
示例:
- observer.on('cellularDataConnectionStateChange', {slotId: 0}, value => {
- console.log("on cellularDataConnectionStateChange, state:" + value.state + ", network:" + value.network);
- });
off(type: 'cellularDataConnectionStateChange', callback?: Callback<{ state: DataConnectState, network: RatType}>): void;
移除訂閱蜂窩數(shù)據(jù)鏈路連接狀態(tài),使用callback方式作為異步方法。
可以指定傳入on中的callback取消一個訂閱,也可以不指定callback清空所有訂閱。
系統(tǒng)能力:SystemCapability.Telephony.StateRegistry
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
type | string | 是 | 蜂窩數(shù)據(jù)鏈路連接狀態(tài)事件,參數(shù)固定為'cellularDataConnectionStateChange'。 |
callback | Callback<{ state: DataConnectState, network: RatType }> | 否 | 回調(diào)函數(shù),參考data的DataConnectState,radio的RadioTechnology。 |
錯誤碼:
以下錯誤碼的詳細介紹請參見ohos.telephony(電話子系統(tǒng))錯誤碼錯誤碼。
錯誤碼ID | 錯誤信息 |
---|---|
401 | Parameter error. |
8300001 | Invalid parameter value. |
8300002 | Operation failed. Cannot connect to service. |
8300003 | System internal error. |
8300999 | Unknown error code. |
示例:
- let callback = value => {
- console.log("on cellularDataConnectionStateChange, state:" + value.state + ", network:" + value.network);
- }
- observer.on('cellularDataConnectionStateChange', callback);
- // 可以指定傳入on中的callback取消一個訂閱,也可以不指定callback清空所有訂閱。
- observer.off('cellularDataConnectionStateChange', callback);
- observer.off('cellularDataConnectionStateChange');
on(type: 'cellularDataFlowChange', callback: Callback<DataFlowType>): void;
訂閱蜂窩數(shù)據(jù)業(yè)務的上下行數(shù)據(jù)流狀態(tài),使用callback方式作為異步方法。
系統(tǒng)能力:SystemCapability.Telephony.StateRegistry
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
type | string | 是 | 蜂窩數(shù)據(jù)業(yè)務的上下行數(shù)據(jù)流狀態(tài)狀態(tài)事件,參數(shù)固定為'cellularDataFlowChange'。 |
callback | Callback<DataFlowType> | 是 | 回調(diào)函數(shù),參考data的DataFlowType。 |
錯誤碼:
以下錯誤碼的詳細介紹請參見ohos.telephony(電話子系統(tǒng))錯誤碼錯誤碼。
錯誤碼ID | 錯誤信息 |
---|---|
401 | Parameter error. |
8300001 | Invalid parameter value. |
8300002 | Operation failed. Cannot connect to service. |
8300003 | System internal error. |
8300999 | Unknown error code. |
示例:
- observer.on('cellularDataFlowChange', data => {
- console.log("on networkStateChange, data:" + JSON.stringify(data));
- });
on(type: 'cellularDataFlowChange', options: { slotId: number }, callback: Callback<DataFlowType>): void;
訂閱指定卡槽位的蜂窩數(shù)據(jù)業(yè)務的上下行數(shù)據(jù)流狀態(tài),使用callback方式作為異步方法。
系統(tǒng)能力:SystemCapability.Telephony.StateRegistry
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
type | string | 是 | 蜂窩數(shù)據(jù)業(yè)務的上下行數(shù)據(jù)流狀態(tài)事件,參數(shù)固定為'cellularDataFlowChange'。 |
slotId | number | 是 | 卡槽ID。 - 0:卡槽1 - 1:卡槽2 |
callback | Callback<DataFlowType> | 是 | 回調(diào)函數(shù),參考data的DataFlowType。 |
錯誤碼:
以下錯誤碼的詳細介紹請參見ohos.telephony(電話子系統(tǒng))錯誤碼錯誤碼。
錯誤碼ID | 錯誤信息 |
---|---|
401 | Parameter error. |
8300001 | Invalid parameter value. |
8300002 | Operation failed. Cannot connect to service. |
8300003 | System internal error. |
8300999 | Unknown error code. |
示例:
- observer.on('cellularDataFlowChange', {slotId: 0}, data => {
- console.log("on cellularDataFlowChange, data:" + JSON.stringify(data));
- });
off(type: 'cellularDataFlowChange', callback?: Callback<DataFlowType>): void;
移除訂閱蜂窩數(shù)據(jù)業(yè)務的上下行數(shù)據(jù)流狀態(tài),使用callback方式作為異步方法。
可以指定傳入on中的callback取消一個訂閱,也可以不指定callback清空所有訂閱。
系統(tǒng)能力:SystemCapability.Telephony.StateRegistry
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
type | string | 是 | 蜂窩數(shù)據(jù)業(yè)務的上下行數(shù)據(jù)流狀態(tài)事件,參數(shù)固定為'cellularDataFlowChange'。 |
callback | Callback<DataFlowType> | 否 | 回調(diào)函數(shù),參考data的DataFlowType。 |
錯誤碼:
以下錯誤碼的詳細介紹請參見ohos.telephony(電話子系統(tǒng))錯誤碼錯誤碼。
錯誤碼ID | 錯誤信息 |
---|---|
401 | Parameter error. |
8300001 | Invalid parameter value. |
8300002 | Operation failed. Cannot connect to service. |
8300003 | System internal error. |
8300999 | Unknown error code. |
示例:
- let callback = data => {
- console.log("on cellularDataFlowChange, data:" + JSON.stringify(data));
- }
- observer.on('cellularDataFlowChange', callback);
- // 可以指定傳入on中的callback取消一個訂閱,也可以不指定callback清空所有訂閱。
- observer.off('cellularDataFlowChange', callback);
- observer.off('cellularDataFlowChange');
on(type: 'simStateChange', callback: Callback<SimStateData>): void;
訂閱sim狀態(tài)更改事件,使用callback方式作為異步方法。
系統(tǒng)能力:SystemCapability.Telephony.StateRegistry
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
type | string | 是 | sim狀態(tài)更改事件,參數(shù)固定為'simStateChange'。 |
callback | Callback<SimStateData> | 是 | 回調(diào)函數(shù)。 |
錯誤碼:
以下錯誤碼的詳細介紹請參見ohos.telephony(電話子系統(tǒng))錯誤碼錯誤碼。
錯誤碼ID | 錯誤信息 |
---|---|
401 | Parameter error. |
8300001 | Invalid parameter value. |
8300002 | Operation failed. Cannot connect to service. |
8300003 | System internal error. |
8300999 | Unknown error code. |
示例:
- observer.on('simStateChange', data => {
- console.log("on simStateChange, data:" + JSON.stringify(data));
- });
on(type: 'simStateChange', options: { slotId: number }, callback: Callback<SimStateData>): void;
訂閱指定卡槽位的sim狀態(tài)更改事件,使用callback方式作為異步方法。
系統(tǒng)能力:SystemCapability.Telephony.StateRegistry
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
type | string | 是 | sim狀態(tài)更改事件,參數(shù)固定為'simStateChange'。 |
slotId | number | 是 | 卡槽ID。 - 0:卡槽1 - 1:卡槽2 |
callback | Callback<SimStateData> | 是 | 回調(diào)函數(shù)。 |
錯誤碼:
以下錯誤碼的詳細介紹請參見ohos.telephony(電話子系統(tǒng))錯誤碼錯誤碼。
錯誤碼ID | 錯誤信息 |
---|---|
401 | Parameter error. |
8300001 | Invalid parameter value. |
8300002 | Operation failed. Cannot connect to service. |
8300003 | System internal error. |
8300999 | Unknown error code. |
示例:
- observer.on('simStateChange', {slotId: 0}, data => {
- console.log("on simStateChange, data:" + JSON.stringify(data));
- });
off(type: 'simStateChange', callback?: Callback<SimStateData>): void;
移除訂閱sim狀態(tài)更改事件,使用callback方式作為異步方法。
可以指定傳入on中的callback取消一個訂閱,也可以不指定callback清空所有訂閱。
系統(tǒng)能力:SystemCapability.Telephony.StateRegistry
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
type | string | 是 | sim狀態(tài)更改事件,參數(shù)固定為'simStateChange'。 |
callback | Callback<SimStateData> | 否 | 回調(diào)函數(shù)。 |
錯誤碼:
以下錯誤碼的詳細介紹請參見ohos.telephony(電話子系統(tǒng))錯誤碼錯誤碼。
錯誤碼ID | 錯誤信息 |
---|---|
401 | Parameter error. |
8300001 | Invalid parameter value. |
8300002 | Operation failed. Cannot connect to service. |
8300003 | System internal error. |
8300999 | Unknown error code. |
示例:
- let callback = data => {
- console.log("on simStateChange, data:" + JSON.stringify(data));
- }
- observer.on('simStateChange', callback);
- // 可以指定傳入on中的callback取消一個訂閱,也可以不指定callback清空所有訂閱。
- observer.off('simStateChange', callback);
- observer.off('simStateChange');
SIM卡鎖類型。
系統(tǒng)能力:以下各項對應的系統(tǒng)能力均為SystemCapability.Telephony.StateRegistry。
名稱 | 值 | 說明 |
---|---|---|
SIM_NONE | 0 | 無鎖。 |
SIM_PIN | 1 | PIN鎖。 |
SIM_PUK | 2 | PUK鎖。 |
SIM_PN_PIN | 3 | 網(wǎng)絡PIN鎖。 |
SIM_PN_PUK | 4 | 網(wǎng)絡PUK鎖。 |
SIM_PU_PIN | 5 | 子網(wǎng)PIN鎖。 |
SIM_PU_PUK | 6 | 子網(wǎng)PUK鎖。 |
SIM_PP_PIN | 7 | 服務提供商PIN鎖。 |
SIM_PP_PUK | 8 | 服務提供商PUK鎖。 |
SIM_PC_PIN | 9 | 組織PIN鎖。 |
SIM_PC_PUK | 10 | 組織PUK鎖。 |
SIM_SIM_PIN | 11 | SIM PIN鎖。 |
SIM_SIM_PUK | 12 | SIM PUK鎖。 |
Copyright©2021 w3cschool編程獅|閩ICP備15016281號-3|閩公網(wǎng)安備35020302033924號
違法和不良信息舉報電話:173-0602-2364|舉報郵箱:jubao@eeedong.com
掃描二維碼
下載編程獅App
編程獅公眾號
聯(lián)系方式:
更多建議: