# 生态查询服务

#### 场景介绍

生态查询服务可以为您提供应用/元服务运行信息的查询，当前提供场景值查询和广告验签信息查询。场景值是用来描述用户进入应用和元服务的路径。您可以通过本服务，来查询您的元服务/应用是通过何种场景被打开的（场景值列表）。当前我们支持元服务的场景值查询，后续我们会继续公布应用场景值的查询。广告验签版本查询只在您的应用涉及广告场景下才会被使用到。您可以通过本查询服务，查询广告验签参数处理逻辑。

#### 业务流程

1.  用户需要查询应用/元服务自身场景值或者查询广告验签版本。
    
2.  应用调用getSelfSceneCode接口和getAdsVerificationVersion接口分别获取自身场景值和广告验签版本。
    
3.  返回自身场景值和广告验签版本给应用/元服务。
    
4.  返回结果给用户。
    

#### 约束与限制

*   生态查询服务支持Phone、Tablet、PC/2in1设备。并且从5.1.1(19)版本开始，新增支持TV设备。
    
*   如果应用或者元服务没有产生场景值，调用getSelfSceneCode接口返回的场景值为空。
    
*   生态查询服务不支持模拟器，请使用真机调试。
    

#### 接口说明

生态查询服务场景提供以下接口，具体API说明详见接口文档。

| 接口名 | 描述 |
| --- | --- |
| getSelfSceneCode():string | 获取自身场景值。 |
| getAdsVerificationVersion(): number | 查询广告验签版本。 |

#### 开发步骤

#### 查询自身场景值

1.  导入模块。
    
    ```
    import { hilog } from '@kit.PerformanceAnalysisKit';
    import { sceneManager } from '@kit.AppGalleryKit';
    ```
    
2.  调用getSelfSceneCode方法。
    
    ```
    try {
      const sceneCode: string = sceneManager.getSelfSceneCode();
      hilog.info(0, 'TAG', "Succeeded in getting SelfSceneCode res = " + sceneCode);
    } catch (error) {
      hilog.error(0, 'TAG', `getSelfSceneCode failed. code is ${error.code}, message is ${error.message}`);
    }
    ```
    

#### 查询广告验签版本

1.  导入模块。
    
    ```
    import { hilog } from '@kit.PerformanceAnalysisKit';
    import { sceneManager } from '@kit.AppGalleryKit';
    ```
    
2.  调用getAdsVerificationVersion方法。
    
    ```
    try {
      const version: number = sceneManager.getAdsVerificationVersion();
      hilog.info(0, 'TAG', "Succeeded in getting AdsVerificationVersion res = " + version);
    } catch (error) {
      hilog.error(0, 'TAG', `getAdsVerificationVersion failed. code is ${error.code}, message is ${error.message}`);
    }
    ```