mirror of
https://gitee.com/openharmony/interface_sdk-js
synced 2024-11-24 07:40:25 +00:00
80 lines
3.6 KiB
TypeScript
80 lines
3.6 KiB
TypeScript
/*
|
|
* Copyright (C) 2021 Huawei Device Co., Ltd.
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
import {Callback} from "./basic";
|
|
import radio from "./@ohos.telephony.radio";
|
|
import call from "./@ohos.telephony.call";
|
|
|
|
/**
|
|
* Monitors telephony state updates of a device, including updates of the network state,
|
|
* signal strength, call state, the data link connection state and others.
|
|
*
|
|
* @since 6
|
|
*/
|
|
declare namespace observer {
|
|
type NetworkState = radio.NetworkState;
|
|
type SignalInformation = radio.SignalInformation;
|
|
type CallState = call.CallState;
|
|
|
|
/**
|
|
* Called when the network state corresponding to a monitored {@code slotId} updates.
|
|
*
|
|
* <p>Applications must have the {@code ohos.permission.GET_NETWORK_INFO} permission
|
|
* to register this event.
|
|
*
|
|
* @param type networkStateChange
|
|
* @param options including slotId Indicates the ID of the target card slot.
|
|
* The value {@code 0} indicates card 1, and the value {@code 1} indicates card 2.
|
|
* @param callback including an instance of the {@code NetworkState} class.
|
|
* @permission ohos.permission.GET_NETWORK_INFO
|
|
*/
|
|
function on(type: 'networkStateChange', callback: Callback<NetworkState>): void;
|
|
function on(type: 'networkStateChange', options: { slotId: number }, callback: Callback<NetworkState>): void;
|
|
|
|
function off(type: 'networkStateChange', callback?: Callback<NetworkState>): void;
|
|
|
|
/**
|
|
* Called when the signal strength corresponding to a monitored {@code slotId} updates.
|
|
*
|
|
* @param type signalInfoChange
|
|
* @param options including slotId Indicates the ID of the target card slot.
|
|
* The value {@code 0} indicates card 1, and the value {@code 1} indicates card 2.
|
|
* @param callback including an array of instances of the classes derived from {@link SignalInformation}.
|
|
*/
|
|
function on(type: 'signalInfoChange', callback: Callback<Array<SignalInformation>>): void;
|
|
function on(type: 'signalInfoChange', options: { slotId: number },
|
|
callback: Callback<Array<SignalInformation>>): void;
|
|
|
|
function off(type: 'signalInfoChange', callback?: Callback<Array<SignalInformation>>): void;
|
|
|
|
/**
|
|
* Receives a call state change. This callback is invoked when the call state of a specified card updates
|
|
* and the observer is added to monitor the updates.
|
|
*
|
|
* @param type callStateChange
|
|
* @param options including slotId Indicates the ID of the target card slot.
|
|
* The value {@code 0} indicates card 1, and the value {@code 1} indicates card 2.
|
|
* @param callback including state Indicates the call state, and number Indicates the called number.
|
|
* The value of number is an empty string if the application does not have
|
|
* the {@code ohos.permission#READ_CALL_LOG READ_CALL_LOG} permission.
|
|
*/
|
|
function on(type: 'callStateChange', callback: Callback<{ state: CallState, number: string }>): void;
|
|
function on(type: 'callStateChange', options: { slotId: number },
|
|
callback: Callback<{ state: CallState, number: string }>): void;
|
|
|
|
function off(type: 'callStateChange', callback?: Callback<{ state: CallState, number: string }>): void;
|
|
}
|
|
|
|
export default observer; |