AICC - 移动端SDK开发指南

    implementation files('libs/xxx.aar')
    implementation("com.koushikdutta.async:androidasync:3.1.0")
    implementation("org.slf4j:slf4j-api:1.7.30")
    implementation("org.webrtc:google-webrtc:1.0.32006")
    implementation("org.java-websocket:Java-WebSocket:1.5.3")

    <!--  录音所需权限  -->
    <uses-permission android:name="android.permission.RECORD_AUDIO" />

    <!--    限制在 Android 12 以下的系统才申请这个蓝牙权限-->
    <uses-permission android:name="android.permission.BLUETOOTH"
        android:maxSdkVersion="30" />
    <!--    适配 Android 12 的蓝牙机制，申请与已配对的蓝牙设备通讯-->
    <uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />

    <!--    网络访问所需权限  -->
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
    <uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" />
    <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />

    <uses-permission
        android:name="android.permission.INJECT_EVENTS"
        tools:ignore="ProtectedPermissions" />

Manifest.permission.RECORD_AUDIO

Manifest.permission.BLUETOOTH_CONNECT

    /**
     * 初始化 SDK，在整个应用程序全局只需要调用一次, 建议在Application继承类中调用。
     *
     */
    TiPhone.init(context);

    /**
     * 语音验证码验证
     *
     * @param code 语音验证码
     */
    TiPhone.getInstance().confirmVerificationCode(code);

    /**
     * 座席下线
     */
    TiPhone.getInstance().logoutWebSocket();

    // 假设要传如下键值对数据（键和值的总字符数不建议超过 100 字符，底层协议帧无法传输过长的数据）
    // id：90007573
    // workNum：1026658
    // depId：340179
    HashMap<String,String> userField = new HashMap<>();
    // 拼接 JSON String , 总字符数不超过 250 字符（含转义字符）
    String jsonString = "{\"id\":\"90007573\",\"workNum\":\"1026658\",\"depId\":\"340179\"}";
    // 使用 callVariables 作为 key，使用指定格式的 JSON 字符串作为 value
    userField.put("callVariables",jsonString);
    TiPhone.getInstance().call( "156xxxx1222","","",userField);

    /**
     * 拨打电话
     *
     * @param phoneNumber     电话号码
     * @param obClid          客户外显号码
     * @param requestUniqueId 通话的唯一标识，如果传入是空则自动生成并且通过消息返回
     * @param userField       用户自定义参数 注:key/value 键值对最多支持5对，key小于20字节，value小于100字节
     */
    TiPhone.getInstance().call( phoneNumBuffer.toString(),"","",null);

TiPhone.getInstance().setOnEventListener(new OnEventListener() {
            @Override
            public void onError(String s) {

            }

            @Override
            public void onEventChange(String event, String msg) {

            }

            @Override
            public void onDestroy() {

            }
        });

        TiPhone.getInstance().setIncomingMessageListener(context, new IIncomingMessageListener() {
            @Override
            public void onMessage(String message) {
                Toast.makeText(MainActivity.this, message, Toast.LENGTH_SHORT).show();
            }

            @Override
            public void onError(String errorMsg) {
                Toast.makeText(MainActivity.this, errorMsg, Toast.LENGTH_SHORT).show();
            }

            @Override
            public void onWebSocketMessage(String errorMsg){
                Toast.makeText(MainActivity.this, errorMsg, Toast.LENGTH_SHORT).show();
            };
        });

{
    "customerNumber": "xxxxxxxxxxxx",  //回呼电话号码
    "mainUniqueId": "sip-2-1585193326.2224"  //通话唯一id
}

tiPhone.hangup();

    /**
    *  发送DTMF消息(信令方式),依赖服务器处理，不需要做间隔等设置(注，由于网络等不可控因素，可以对比俩种DTMF发送方式选择其中一种效果更好的使用)
     * @param tones        所需要发送的DTMF消息.
     * @param duration     消息时长 单位：毫秒 该参数指示每个在tones参数中传递的字符。持续时间不能超过小于6000ms或小于70ms
     * @param interToneGap 消息间隔 单位：毫秒 该参数表示字符之间的间隔，此参数必须至少为50ms,但应尽可能短
     */
     TiPhone.getInstance().sendDTMFSignaling(String tones);

    /**
    * 对发送DTMF符号的任务进行排队。处理tones参数作为一系列字符。字符0到9、A到D、#和*,生成相关的DTMF符号。字符a到d与A到D是等效的。字符","表示在处理tones参数中的下一个字符之前延迟2秒
     * @param tones        所需要发送的DTMF消息.
     * @param duration     消息时长 单位：毫秒 该参数指示每个在tones参数中传递的字符。持续时间不能超过小于6000ms或小于70ms
     * @param interToneGap 消息间隔 单位：毫秒 该参数表示字符之间的间隔，此参数必须至少为50ms,但应尽可能短
     */
     TiPhone.getInstance().sendDTMF(String tones, int duration, int interToneGap);

    /**
     * 禁音/恢复音量
     *
     * @return true  禁音
     *         false 恢复音量(默认)
     */
     TiPhone.getInstance().setMicrophoneMute(boolean muted);

    /**
     * 获取扬声器状态启用状态
     *
     * @return true  扬声器已开启，语音会输出到扬声器
     *         false 扬声器未开启，语音会输出到听筒
     */
    TiPhone.getInstance().isSpeakerphoneEnabled();

    /**
     * 启用/关闭扬声器播放
     *
     * @param enabled true：启用扬声器播放
     *                false：关闭扬声器播放
     */
    TiPhone.getInstance().setEnableSpeakerphone(enabled);

    /**
     * 开启log
     *
     * @param isDebug true：开启
     *                false：关闭
     */
    TiPhone.getInstance().setDebug(isDebug);

    /**
     * 配置手机号外显
     *
     * @param isTelExplicit true：使用手机号码外显
     *                      false：使用固话号码外显
     */
    TiPhone.getInstance().setTelExplicit(true);

TiPhoneSDK.framework 为 Do Not Embed

WebRTC.framework 为 Embed & Sign

Privacy - Camera Usage Description
Privacy - Microphone Usage Description

/**
 获取实例
 */
+(id)shareInstance;

/**
 认证语音验证码
 @param code 输入电话听到的语音验证码
 @param successBlock  验证码确认并登录成功的回调
 @param errorBlock   确认验证码失败的回调 [status:失败的错误码]
*/
-(void)confirmVerify:(NSString *)code success:(void (^)(NSString *strCno))successBlock error:(void (^)(TILoginErrorCode status,NSString *errorDes))errorBlock;

/// 座席下线
- (void)logoutWebSocket;

/**
 拨打电话
 @param obClid 客户外显号码
 @param number 需要拨打的手机号
 @param requestUniqueId 通话的唯一标识 如果传入为@""SDK生成并在消息中返回所生成的唯一标识 P-Tinet-Request-Unique-Id
 @param userField 自定义参数  注:key/value 键值对最多支持5对，key小于20字节，value小于100字节，value必须为json字符串
 ex: {
      @"callVariables":@"{\"id\":\"90007573\",\"workNum\":\"1026658\",\"depId\":\"340179\"}"
    }
*/
-(void)call:(NSString * _Nonnull)obClid number:(NSString *_Nonnull) number
  requestUniqueId:(NSString* _Nonnull)requestUniqueId userField:(NSDictionary *_Nullable)userField error:(void (^)(TILoginErrorCode status,NSString *errorDes))errorBlock;

/**
 设置回呼监听 需要在登录成功之后调用
@param listener TiIncomingMessageListener接口的实例
*/
-(void)setIncomingMessageListener:(id<TiIncomingMessageListener>)listener error:(void (^)(NSString *errorDes))errorBlock;

/**
 设置回调接口(回调消息为拨打电话之后的消息)
 @param listener TiPhoneMessageListener接口的实例
 */
-(void)setOnEventListener:(id<TiPhoneMessageListener>)listener;

const static int MESSAGE_REGISTERED            = 101;    // 注册成功
const static int MESSAGE_REGISTER_FAILED       = 102;    // 注册失败
const static int MESSAGE_CALLING               = 103;    // 响铃中
const static int MESSAGE_ACCEPTED              = 104;    // 已接通
const static int MESSAGE_HANGUP                = 105;    // 已挂断
const static int MESSAGE_ERROR                 = 400;    // 错误信息
// 监听接口定义
@protocol TiPhoneMessageListener
- (void)onPushMessage:(int)msgId withParam:(NSString*)param;
@end

/**
 座席状态监听代理 根据内部座席状态的改变回调,设置在
*/
@protocol TiIncomingMessageListener
- (void)onIncomingMessage:(NSString*)param;

/// 被踢下线、其他端登录事件
- (void)onKickout;
@end

-(void)hangup;

/**
 发送DTMF消息(信令方式),依赖服务器处理，不需要做间隔等设置(注，由于网络等不可控因素，可以对比俩种DTMF发送方式选择其中一种效果更好的使用)

 @param tones          所需要发送的DTMF消息.
*/
-(void)sendDTMFSignaling:(NSString *)tones;

/**
* 对发送DTMF符号的任务进行排队。处理tones参数作为一系列字符。字符0到9、A到D、#和*,生成相关的DTMF符号。字符a到d与A到D是等效的。字符","表示在处理tones参数中的下一个字符之前延迟2秒
* @param tones          所需要发送的DTMF消息.
* @param duration       消息时长 单位：秒  该参数指示每个在tones参数中传递的字符。持续时间不能超过小于6000ms或小于70ms
* @param interToneGap   消息间隔 单位：秒  该参数表示字符之间的间隔，此参数必须至少为50ms,但应尽可能短
*/
-(void)sendDTMF:(NSString *)tones duration:(NSTimeInterval)duration interToneGap:(NSTimeInterval)interToneGap;

/**
* @param muted  是否禁音
*                   TRUE    ：禁音
*                   FALSE   ：恢复音量（默认）
*/
-(void)setMicrophoneMute:(BOOL)muted;

/**
* @return TRUE  扬声器已开启，语音会输出到扬声器
* @return FALSE 扬声器未开启，语音会输出到听筒
*/
-(BOOL)isSpeakerphoneEnabled;

/**
* @param enabled 是否将音频外放
*                   TRUE    ：切换到外放
                    FALSE   ：切换到听筒。
*/
-(void)setEnableSpeakerphone:(BOOL)enabled;

/**
* 获取SDK版本号
*/
-(NSString *)getVersion;

/**
* log文件名称   ：tiphone_sdk_(版本号)_ + （当前日期） + .txt
* log文件路径在当前应用的Document下;默认最大100MB，如果超过会删除
*
* @param isDebug 是否开启log
*                   TRUE    ：开启打印log
*                   FALSE   ：关闭打印log
*/
-(void)setDebug:(BOOL)isDebug;

/**
 设置是否切换手机号外显还是固话外显
 @isTelObClid 是否需要手机号外显
*/
-(void)setTelObClid:(BOOL)isTelObClid;

@property (nonatomic, weak) id <TiPhoneWebSocketDelegate> webSocketDelegate;

@protocol TiPhoneWebSocketDelegate <NSObject>
- (void)onWebSocketMessage:(NSString *)param;
@end