zmywly8866 / phonenumber

一个获取号码归属地和其他信息（诈骗、*扰等）的开源库

PhoneNumber

一个获取号码归属地和其他信息（诈骗、*扰等）的开源库。支持本地离线（含归属地、*扰、常用号码）和网络（百度、聚合数据或自定义 API）查询。English

下载

通过 gradle 下载

dependencies {
    compile 'org.xdty.phone.number:phone-number:0.5.0'
}

或 maven

<dependency>
  <groupId>org.xdty.phone.number</groupId>
  <artifactId>phone-number</artifactId>
  <version>0.5.0</version>
  <type>aar</type>
</dependency>

或从 maven central 直接下载 AAR 文件

用法

1. 添加 meta-data 到 AndroidManifest

<meta-data
    android:name="org.xdty.phone.number.API_KEY"
    android:value="API_KEY"/>
<meta-data
    android:name="org.xdty.phone.number.JUHE_API_KEY"
    android:value="JUHE_API_KEY"/>

你可以从 百度 API 中心 获取 API_KEY , 从 聚合数据 (360) 获取 JUHE_API_KEY。这一部分是用于联网查询的 API 私钥。

也可以在代码中设置 baidu_api_key 和 juhe_api_key 的 SharedPreferences 来动态控制 API 密钥，更多内容请参考 来电信息 的实现。

2. 代码中添加如下内容, 更多内容请参考 example 和 CallerInfo

new PhoneNumber(this, new PhoneNumber.Callback() {
    @Override
    public void onResponseOffline(INumber number) {
    }
    
    @Override
    public void onResponse(INumber number) {
        // Do your jobs here
        textView.setText(number.getName());
    }

    @Override
    public void onResponseFailed(INumber number) {
    }
}).fetch("10086", "10000", "10001", "OTHER_PHONE_NUMBER");

本地查询会通过 onResponseOffline(INumber number) 返回，联网查询会通过 onResponse(INumber number) 返回。

3. 自定义服务器及 API

请参考 自定义 API 文档

4. 自定义号码处理器

请参考 model 中的实现，实现 INumber 和 NumberHandler 接口。并在调用 fetch 前调用 addNumberHandler(new YourCustomNumberHandler())。

5. 禁用联网查询

请设置 only_offline_key 的 SharedPreferences 来全局控制，或使用 PhoneNumber(context, true, callback) 临时控制。

6. 优先查询控制

默认的查询顺序为 本地特殊号码->本地常用号码->本地标记号码->本地离线归属地->Google离线归属地->联网自定义 API->联网百度 API->联网聚合数据(360) API 。可以通过设置 api_type 的 SharedPreferences 来控制优先的网络查询接口，值为每个模块的 getApiId() 返回值。