1# Interface (ZoomQuery) 2<!--Kit: Camera Kit--> 3<!--Subsystem: Multimedia--> 4<!--Owner: @qano--> 5<!--Designer: @leo_ysl--> 6<!--Tester: @xchaosioda--> 7<!--Adviser: @zengyawen--> 8 9> **说明：** 10> 11> - 本模块首批接口从API version 10开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 12> - 本Interface的起始版本为API version 12。接口在API version 12发生兼容变更，保留了内层元素的起始版本信息，会出现外层元素@since版本号大于内层元素的情况，不影响接口使用。 13 14提供了与设备的缩放相关的查询功能，包括获取支持的缩放比例范围。 15 16## 导入模块 17 18```ts 19import { camera } from '@kit.CameraKit'; 20``` 21 22## getZoomRatioRange<sup>11+</sup> 23 24getZoomRatioRange(): Array\<number\> 25 26获取支持的变焦范围。 27 28**原子化服务API：** 从API version 19开始，该接口支持在原子化服务中使用。 29 30**系统能力：** SystemCapability.Multimedia.Camera.Core 31 32**返回值：** 33 34| 类型 | 说明 | 35| ---------- | ----------------------------- | 36| Array\<number\> | 用于获取可变焦距比范围，返回的数组包括其最小值和最大值。接口调用失败会返回相应错误码，错误码类型[CameraErrorCode](arkts-apis-camera-e.md#cameraerrorcode)。 | 37 38**错误码：** 39 40以下错误码的详细介绍请参见[Camera错误码](errorcode-camera.md)。 41 42| 错误码ID | 错误信息 | 43| --------------- | --------------- | 44| 7400103 | Session not config, only throw in session usage. | 45 46**示例：** 47 48```ts 49import { BusinessError } from '@kit.BasicServicesKit'; 50 51function getZoomRatioRange(photoSession: camera.PhotoSession): Array<number> { 52 let zoomRatioRange: Array<number> = []; 53 try { 54 zoomRatioRange = photoSession.getZoomRatioRange(); 55 } catch (error) { 56 // 失败返回错误码error.code并处理。 57 let err = error as BusinessError; 58 console.error(`The getZoomRatioRange call failed. error code: ${err.code}`); 59 } 60 return zoomRatioRange; 61} 62``` 63