* Copyright (C) 2021-2023 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.
*/
#ifndef CELLULAR_CALL_PROXY_H
#define CELLULAR_CALL_PROXY_H
#include "cellular_call_interface.h"
#include "cellular_call_ipc_interface_code.h"
#include "iremote_proxy.h"
namespace OHOS {
namespace Telephony {
class CellularCallProxy : public IRemoteProxy<CellularCallInterface> {
public:
* @brief Construct a new Cellular Call Proxy object
*
* @param impl
*/
explicit CellularCallProxy(const sptr<IRemoteObject> &impl) : IRemoteProxy<CellularCallInterface>(impl) {}
* @brief Destroy the Cellular Call Proxy object
*/
~CellularCallProxy() = default;
* @brief dial a call
*
* @param callInfo[in] the call detail info which contains phone number, call type, slot id .etc
* @return Returns TELEPHONY_SUCCESS on success, others on failure.
*/
int32_t Dial(const CellularCallInfo &callInfo) override;
* @brief hang up a call
*
* @param callInfo[in] the call detail info which contains phone number, call type, slot id .etc
* @param type[in] Indicates the +CHLD related supplementary services.
* @return Returns TELEPHONY_SUCCESS on success, others on failure.
*/
int32_t HangUp(const CellularCallInfo &callInfo, CallSupplementType type) override;
* @brief reject a call
*
* @param callInfo[in] the call detail info which contains phone number, call type, slot id .etc
* @return Returns TELEPHONY_SUCCESS on success, others on failure.
*/
int32_t Reject(const CellularCallInfo &callInfo) override;
* @brief answer a call
*
* @param callInfo[in] the call detail info which contains phone number, call type, slot id .etc
* @return Returns TELEPHONY_SUCCESS on success, others on failure.
*/
int32_t Answer(const CellularCallInfo &callInfo) override;
* @brief hold a call
*
* @param callInfo[in] the call detail info which contains phone number, call type, slot id .etc
* @return Returns TELEPHONY_SUCCESS on success, others on failure.
*/
int32_t HoldCall(const CellularCallInfo &callInfo) override;
* @brief unhold a call
*
* @param callInfo[in] the call detail info which contains phone number, call type, slot id .etc
* @return Returns TELEPHONY_SUCCESS on success, others on failure.
*/
int32_t UnHoldCall(const CellularCallInfo &callInfo) override;
* @brief switch the call
*
* @param callInfo[in] the call detail info which contains phone number, call type, slot id .etc
* @return Returns TELEPHONY_SUCCESS on success, others on failure.
*/
int32_t SwitchCall(const CellularCallInfo &callInfo) override;
* @brief Checks whether the called number is an emergency number
*
* @param slotId[in] the slot id
* @param phoneNum[in] the phone number
* @param enabled[out] if the phone number is ecc, true is yes, false is no
* @return Returns TELEPHONY_SUCCESS on success, others on failure.
*/
int32_t IsEmergencyPhoneNumber(int32_t slotId, const std::string &phoneNum, bool &enabled) override;
* @brief Merge into multiple calls
*
* @param callInfo[in] the call detail info which contains phone number, call type, slot id .etc
* @return Returns TELEPHONY_SUCCESS on success, others on failure.
*/
int32_t CombineConference(const CellularCallInfo &callInfo) override;
* @brief Separate the Conference call
*
* @param callInfo[in] the call detail info which contains phone number, call type, slot id .etc
* @return Returns TELEPHONY_SUCCESS on success, others on failure.
*/
int32_t SeparateConference(const CellularCallInfo &callInfo) override;
* @brief Invite someone to the conference call
*
* @param numberList[in] the number list to invite to conference
* @param slotId[in] the slot id
* @return Returns TELEPHONY_SUCCESS on success, others on failure.
*/
int32_t InviteToConference(int32_t slotId, const std::vector<std::string> &numberList) override;
* @brief Kick out someone from the conference call
*
* @param callInfo[in] the call detail info which contains phone number, call type, slot id .etc
* @return Returns TELEPHONY_SUCCESS on success, others on failure.
*/
int32_t KickOutFromConference(const CellularCallInfo &callInfo) override;
* @brief Hang Up All Connection
*
* @return Returns TELEPHONY_SUCCESS on success, others on failure.
*/
int32_t HangUpAllConnection() override;
* @brief Hang Up All Connection
*
* @param slotId[in] the slot id
* @return Returns TELEPHONY_SUCCESS on success, others on failure.
*/
int32_t HangUpAllConnection(int32_t slotId) override;
* @brief set whether the device can make calls
*
* @param slotId[in] the slot id
* @param callType[in] indicate the call type is cs or ims. 0 is cs, 1 is ims
* @param isReadyToCall[in] indicate whether the device can make calls
* @return Returns TELEPHONY_SUCCESS on success, others on failure.
*/
int32_t SetReadyToCall(int32_t slotId, int32_t callType, bool isReadyToCall) override;
* @brief IMS Send Call Media Mode Request
*
* @param callInfo[in] the call detail info which contains phone number, call type, slot id .etc
* @param mode[in] indicate the call mode just like audio only, receive only .etc
* @return Returns TELEPHONY_SUCCESS on success, others on failure.
*/
int32_t SendUpdateCallMediaModeRequest(const CellularCallInfo &callInfo, ImsCallMode mode) override;
* @brief IMS Send Call Media Mode Response
*
* @param callInfo[in] the call detail info which contains phone number, call type, slot id .etc
* @param mode[in] indicate the call mode just like audio only, receive only .etc
* @return Returns TELEPHONY_SUCCESS on success, others on failure.
*/
int32_t SendUpdateCallMediaModeResponse(const CellularCallInfo &callInfo, ImsCallMode mode) override;
* @brief start to paly a dtmf tone
*
* @param cDtmfCode[in] A character indicate the DTMF digit for which to play the tone. This
* value must be one of {0~9}, {*} or {#}.
* @param callInfo[in] the call detail info which contains phone number, call type, slot id .etc
* @return Returns TELEPHONY_SUCCESS on success, others on failure.
*/
int32_t StartDtmf(char cDtmfCode, const CellularCallInfo &callInfo) override;
* @brief stop the playing dtmf tone
*
* @param callInfo[in] the call detail info which contains phone number, call type, slot id .etc
* @return Returns TELEPHONY_SUCCESS on success, others on failure.
*/
int32_t StopDtmf(const CellularCallInfo &callInfo) override;
int32_t PostDialProceed(const CellularCallInfo &callInfo, const bool proceed) override;
* @brief play a dtmf tone
*
* @param cDtmfCode[in] A character indicate the DTMF digit for which to play the tone. This
* value must be one of {0~9}, {*} or {#}.
* @param callInfo[in] the call detail info which contains phone number, call type, slot id .etc
* @return Returns TELEPHONY_SUCCESS on success, others on failure.
*/
int32_t SendDtmf(char cDtmfCode, const CellularCallInfo &callInfo) override;
#ifdef SUPPORT_RTT_CALL
* @brief Rtt Upgrade or Downgrade
*
* @param slotId[in] the slot id
* @param callId[in] call id
* @param mode[in] rtt modify mode
* @return Returns TELEPHONY_SUCCESS on success, others on failure.
*/
int32_t UpdateImsRttCallMode(int32_t slotId, int32_t callId, ImsRTTCallMode mode) override;
* @brief RTT Call Switch Settings
*
* @param slotId[in], The slot id
* @param isEnabled[out], The result of enable or not
* @return Returns 0 on success, others on failure.
*/
int32_t SetRttCapability(int32_t slotId, bool isEnable) override;
#endif
* @brief set call transfer for the slot id
*
* @param ctInfo[in] contains the call transfer type, enable/disable, the transfered number, the start/end time
* @param slotId[in] the slot id
* @return Returns TELEPHONY_SUCCESS on success, others on failure.
*/
int32_t SetCallTransferInfo(int32_t slotId, const CallTransferInfo &cfInfo) override;
* @brief confirm whether IMS can set call transfer time
*
* @param slotId[in] the slot id
* @param result[out] whether IMS can set call transfer time. true mean yes, false mean no
* @return Returns TELEPHONY_SUCCESS on success, others on failure.
*/
int32_t CanSetCallTransferTime(int32_t slotId, bool &result) override;
* @brief Get Call Transfer information
*
* @param type[in] indicate the call transfer type, just like CFU, CFB, CFNRy, CFNRc
* @param slotId[in] the slot id
* @return Returns TELEPHONY_SUCCESS on success, others on failure.
*/
int32_t GetCallTransferInfo(int32_t slotId, CallTransferType type) override;
* @brief Set Call Waiting
*
* @param activate[in] true mean activate the call waiting, false mean inactivate
* @param slotId[in] the slot id
* @return Returns TELEPHONY_SUCCESS on success, others on failure.
*/
int32_t SetCallWaiting(int32_t slotId, bool activate) override;
* @brief Gets whether the call waiting service of the current account is enabled
*
* @param slotId[in] the slot id
* @return Returns TELEPHONY_SUCCESS on success, others on failure.
*/
int32_t GetCallWaiting(int32_t slotId) override;
* @brief Gets whether the call waiting service of the current account is enabled
*
* @param slotId[in] the slot id
* @param enabled
* @return Returns TELEPHONY_SUCCESS on success, others on failure.
*/
int32_t GetVideoCallWaiting(int32_t slotId, bool &enabled) override;
* @brief Set the call restriction function for the current account
*
* @param cRInfo[in] contains the password, call restriction type and call restriction mode
* @param slotId[in] the slot id
* @return Returns TELEPHONY_SUCCESS on success, others on failure.
*/
int32_t SetCallRestriction(int32_t slotId, const CallRestrictionInfo &crInfo) override;
* @brief Set the call restriction password of the specified account
*
* @param slotId[in] the slot id
* @param fac[in] indicate the call restriction type, just like all incoming, all outgoing .etc
* @param oldPassword[in] indicate the call restriction old password
* @param newPassword[in] indicate the call restriction new password
* @return Returns TELEPHONY_SUCCESS on success, others on failure.
*/
int32_t SetCallRestrictionPassword(
int32_t slotId, CallRestrictionType fac, const char *oldPassword, const char *newPassword) override;
* @brief Gets the call restriction information of the specified account
*
* @param facType[in] indicate the call restriction type, just like all incoming, all outgoing .etc
* @param slotId[in] the slot id
* @return Returns TELEPHONY_SUCCESS on success, others on failure.
*/
int32_t GetCallRestriction(int32_t slotId, CallRestrictionType facType) override;
* @brief Register CallManager CallBack ptr
*
* @param callback callback ptr
* @return Returns TELEPHONY_SUCCESS on success, others on failure.
*/
int32_t RegisterCallManagerCallBack(const sptr<ICallStatusCallback> &callback) override;
* @brief UnRegister CallManager CallBack ptr
*
* @return Returns TELEPHONY_SUCCESS on success, others on failure.
*/
int32_t UnRegisterCallManagerCallBack() override;
* @brief Set Domain Preference Mode
*
* @param mode[in] indicate the domain preference, 1: CS only, 2: CS prefer, 3: PS prefer, 4: PS only
* @param slotId[in] the slot id
* @return Returns TELEPHONY_SUCCESS on success, others on failure.
*/
int32_t SetDomainPreferenceMode(int32_t slotId, int32_t mode) override;
* @brief Get Domain Preference Mode
*
* @param slotId[in] the slot id
* @return Returns TELEPHONY_SUCCESS on success, others on failure.
*/
int32_t GetDomainPreferenceMode(int32_t slotId) override;
* @brief Set Ims Switch Status
*
* @param active[in] indicate the ims switch status, true is on, false is off
* @param slotId[in] the slot id
* @return Returns TELEPHONY_SUCCESS on success, others on failure.
*/
int32_t SetImsSwitchStatus(int32_t slotId, bool active) override;
* @brief Get Ims Switch Status
*
* @param slotId[in] the slot id
* @param enabled[out] indicate the ims switch status, true is on, false is off
* @return Returns TELEPHONY_SUCCESS on success, others on failure.
*/
int32_t GetImsSwitchStatus(int32_t slotId, bool &enabled) override;
* @brief Get Carrier Vt Config
*
* @param slotId[in] the slot id
* @param enabled[out] indicate the carrier vt config, true is support, false is not support
* @return Returns TELEPHONY_SUCCESS on success, others on failure.
*/
int32_t GetCarrierVtConfig(int32_t slotId, bool &enabled) override;
* @brief Set VoNR Switch Status
*
* @param state[in] Indicates the VoNR state, 0: off, 1: on
* @param slotId[in] the slot id
* @return Returns TELEPHONY_SUCCESS on success, others on failure.
*/
int32_t SetVoNRState(int32_t slotId, int32_t state) override;
* @brief Get VoNR Switch Status
*
* @param slotId[in] the slot id
* @param state[out] Indicates the VoNR state, 0: off, 1: on
* @return Returns TELEPHONY_SUCCESS on success, others on failure.
*/
int32_t GetVoNRState(int32_t slotId, int32_t &state) override;
* @brief Set Ims Config
*
* @param item[in] Identify specific item, like ITEM_VIDEO_QUALITY, ITEM_IMS_SWITCH_STATUS
* @param value[in] The specific value corresponding to the item
* @param slotId[in] the slot id
* @return Returns TELEPHONY_SUCCESS on success, others on failure.
*/
int32_t SetImsConfig(int32_t slotId, ImsConfigItem item, const std::string &value) override;
* @brief Set Ims Config
*
* @param item[in] Identify specific item, like ITEM_VIDEO_QUALITY, ITEM_IMS_SWITCH_STATUS
* @param value[in] The specific value corresponding to the item
* @param slotId[in] the slot id
* @return Returns TELEPHONY_SUCCESS on success, others on failure.
*/
int32_t SetImsConfig(int32_t slotId, ImsConfigItem item, int32_t value) override;
* @brief Get Ims Config
*
* @param item[in] Identify specific item, like ITEM_VIDEO_QUALITY, ITEM_IMS_SWITCH_STATUS
* @param slotId[in] the slot id
* @return Returns TELEPHONY_SUCCESS on success, others on failure.
*/
int32_t GetImsConfig(int32_t slotId, ImsConfigItem item) override;
* @brief Set Ims Feature Value
*
* @param type[in] the ims feature item, like VoLTE, ViLTE, SS over UT
* @param value[in] The specific value corresponding to the item
* @param slotId[in] the slot id
* @return Returns TELEPHONY_SUCCESS on success, others on failure.
*/
int32_t SetImsFeatureValue(int32_t slotId, FeatureType type, int32_t value) override;
* @brief Get Ims Feature Value
*
* @param type[in] the ims feature item, like VoLTE, ViLTE, SS over UT
* @param slotId[in] the slot id
* @return Returns TELEPHONY_SUCCESS on success, others on failure.
*/
int32_t GetImsFeatureValue(int32_t slotId, FeatureType type) override;
* @brief set camara to be enabled for video call
*
* @param slotId[in] the slot id
* @param index[in] the index of call
* @param cameraId[in] The id of the camera
* @return Returns TELEPHONY_SUCCESS on success, others on failure.
*/
int32_t ControlCamera(int32_t slotId, int32_t index, const std::string &cameraId) override;
* @brief set a window which used to display a preview of camera capturing
*
* @param slotId[in] the slot id
* @param index[in] the index of call
* @param surfaceId[in] the window information
* @param surface[in] the window information
* @return Returns TELEPHONY_SUCCESS on success, others on failure.
*/
int32_t SetPreviewWindow(
int32_t slotId, int32_t index, const std::string &surfaceId, sptr<Surface> surface) override;
* @brief set a window which used to display the viedo which is received from remote
*
* @param slotId[in] the slot id
* @param index[in] the index of call
* @param surfaceId[in] the window information
* @param surface[in] the window information
* @return Returns TELEPHONY_SUCCESS on success, others on failure.
*/
int32_t SetDisplayWindow(
int32_t slotId, int32_t index, const std::string &surfaceId, sptr<Surface> surface) override;
* @brief set camera zoom ratio
*
* @param zoomRatio[in] the camera zoom ratio
* @return Returns TELEPHONY_SUCCESS on success, others on failure.
*/
int32_t SetCameraZoom(float zoomRatio) override;
* @brief set a image which will be displayed when the video signal is paused
*
* @param slotId[in] the slot id
* @param index[in] the index of call
* @param path[in] the dispalyed image path
* @return Returns TELEPHONY_SUCCESS on success, others on failure.
*/
int32_t SetPausePicture(int32_t slotId, int32_t index, const std::string &path) override;
* @brief set the device orientation
*
* @param slotId[in] the slot id
* @param index[in] the index of call
* @param rotation[in] The device orientation, in degrees
* @return Returns TELEPHONY_SUCCESS on success, others on failure.
*/
int32_t SetDeviceDirection(int32_t slotId, int32_t index, int32_t rotation) override;
* @brief Set the mute state of the call
*
* @param mute[in] 1 means the call could be muted
* @param slotId[in] the slot id
* @return Returns TELEPHONY_SUCCESS on success, others on failure.
*/
int32_t SetMute(int32_t mute, int32_t slotId) override;
* @brief Get the mute state of the call
*
* @param slotId[in] the slot id
* @return Returns TELEPHONY_SUCCESS on success, others on failure.
*/
int32_t GetMute(int32_t slotId) override;
* @brief Set emergency phone number
*
* @param eccVecr[in] ecc number info list
* @param slotId[in] The slot id
* @return Returns TELEPHONY_SUCCESS on true, others on false.
*/
int32_t SetEmergencyCallList(int32_t slotId, std::vector<EmergencyCall> &eccVec) override;
* @brief Close Unfinished ussd function for the current account
*
* @param slotId[in] the slot id
* @return Returns TELEPHONY_SUCCESS on success, others on failure.
*/
int32_t CloseUnFinishedUssd(int32_t slotId) override;
* @brief clear all call if cellular call service restart
*
* @param infos[in] the call detail info vector which contains phone number, call type, slot id .etc
* @return Returns TELEPHONY_SUCCESS on success, others on failure.
*/
int32_t ClearAllCalls(const std::vector<CellularCallInfo> &infos) override;
* @brief cancel call upgrade
*
* @param slotId[in] the slot id
* @param index[in] the index of call
* @return Returns 0 on success, others on failure.
*/
int32_t CancelCallUpgrade(int32_t slotId, int32_t index) override;
* @brief request camera capabilities
*
* @param slotId[in] the slot id
* @param index[in] the index of call
* @return Returns 0 on success, others on failure.
*/
int32_t RequestCameraCapabilities(int32_t slotId, int32_t index) override;
* @brief send ussd response to modem
*
* @param slotId[in] the slot id
* @param content[in] the content need send to modem
* @return Returns TELEPHONY_SUCCESS on success, others on failure.
*/
int32_t SendUssdResponse(int32_t slotId, const std::string &content) override;
* @brief is mmi code
*
* @param slotId[in] the slot id
* @param number[in] the phone number
* @return Returns true on phone number is mmi code, else return false.
*/
bool IsMmiCode(int32_t slotId, std::string &number) override;
private:
* @brief SetCommonParamForMessageParcel, set common param for MessageParcel
*
* @param slotId[in] the slot id
* @param in[out] the MessageParcel which will contain some common parameters like slotid, token,
* max size while the return is success.
* @return Returns TELEPHONY_SUCCESS on success, others on failure.
*/
int32_t SetCommonParamForMessageParcel(int32_t slotId, MessageParcel &in);
private:
static inline BrokerDelegator<CellularCallProxy> delegator_;
__attribute__((noinline)) int32_t SendRequest(int32_t msgId, MessageParcel &dataParcel, MessageParcel &replyParcel,
MessageOption &option);
};
}
}
#endif
