# Builder ```java public static class Builder ``` 构建 `ImageDecoderConfig.Builder` 对象。 ## 成员函数 | 返回 | 名称 | | --- | --- | | Builder | [addDecodingCapability](#Builder-adddecodingcapability) | | ImageDecoderConfig | [build](#Builder-build) | ## 函数说明 ### addDecodingCapability ```java public Builder addDecodingCapability( ImageFormat imageFormat, ImageFormat.FormatChecker imageFormatChecker, ImageDecoder decoder ) ``` 为指定的图片格式增加解码能力。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | imageFormat | ImageFormat | 图片格式 | | imageFormatChecker | ImageFormat.FormatChecker | 用于验证图像格式的格式检查器，详见 [FormatChecker](#FormatChecker-getheadersize)。 | | decoder | ImageDecoder | 用于解码指定图像格式的解码器 | **返回值** `ImageDecoderConfig.Builder` 新实例。 ### build ```java public ImageDecoderConfig build() ``` 构建方法，返回一个 `ImageDecoderConfig` 新实例。 **返回值** `ImageDecoderConfig` 新实例。 # FrescoMonitor ```java public class FrescoMonitor ``` Fresco 监控管理器。 ## 静态函数 | 返回 | 名称 | | --- | --- | | static void | [addImageTraceListener](#FrescoMonitor-addimagetracelistener) | | static void | [addImageTraceListener](#FrescoMonitor-addimagetracelistener-2) | | static void | [addMonitorHookV2](#FrescoMonitor-addmonitorhookv2) | | static void | [removeMonitorHookV2](#FrescoMonitor-removemonitorhookv2) | | static void | [setReportHitCacheEnabled](#FrescoMonitor-setreporthitcacheenabled) | | static void | [setExceedTheLimitBitmapMonitorLimit](#FrescoMonitor-setexceedthelimitbitmapmonitorlimit) | | static void | [setExceedTheLimitBitmapMonitorEnabled](#FrescoMonitor-setexceedthelimitbitmapmonitorenabled) | | static void | [setEnableAllSourceUriReport](#FrescoMonitor-setenableallsourceurireport) | ## 函数说明 ### addImageTraceListener ```java public static void addImageTraceListener(ImageTraceListener imageTraceListener) ``` 设置图片请求成功和失败的监听器。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | imageTraceListener | ImageTraceListener | 图片请求成功和失败的监听器，详见 [ImageTraceListener](1262420#ImageTraceListener)。 | ### addImageTraceListener ```java public static void addImageTraceListener( Context context, ImageTraceListener imageTraceListener ) ``` 设置图片请求成功和失败的监听器。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | context | Context | 上下文对象。请使用 Application 的 Context 对象，否则可能会有泄漏风险。 | | imageTraceListener | ImageTraceListener | 设置图片请求成功和失败的监听器，详见 [ImageTraceListener](1262420#ImageTraceListener)。 | ### addMonitorHookV2 ```java public static void addMonitorHookV2(IMonitorHookV2 monitorHookV2) ``` 添加 hook 接口。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | monitorHookV2 | IMonitorHookV2 | 图片请求和展示的 hook 接口。 | **注意** - 当数据在图片请求成功、失败和取消以及图片结果（包括渐进式加载的中间结果）成功显示的时候，会触发 hook 逻辑。 - 如果 hook 接口的生命周期较短，需要手动调用 [removeMonitorHookV2](#FrescoMonitor-removemonitorhookv2) 方法进行移除，以避免可能的内存泄漏。 ### removeMonitorHookV2 ```java public static void removeMonitorHookV2(IMonitorHookV2 monitorHookV2) ``` 移除已添加的 hook 接口。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | monitorHookV2 | IMonitorHookV2 | 需要移除的图片请求和展示的 hook 接口。 | ### setReportHitCacheEnabled ```java public static void setReportHitCacheEnabled(boolean reportHitCacheEnabled) ``` 设置上报缓存命中的数据。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | reportHitCacheEnabled | boolean | 是否上报缓存命中的数据。

`true`：是

`false`：（默认）否

| **注意** 由于上报缓存数据将产生性能影响同时命中缓存的耗时较小，且相较网络下载性能日志有部分维度数据的缺失，因此不推荐上报缓存数据。 ### setExceedTheLimitBitmapMonitorLimit ```java public static void setExceedTheLimitBitmapMonitorLimit( long limitFileSize, int limitBitmapContrast, long limitRamSize ) ``` 设置大图限制。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | limitFileSize | long | 文件大小阈值，当图片大于该阈值后就认为是大图，默认值是 20M。 | | limitBitmapContrast | int | 图片分辨率大小大于展示 view 尺寸的自定义倍数阈值，当图片 size 大于该阈值后就认为是大图，默认值是 2 倍。 | | limitRamSize | long | 位图内存大小阈值，当图片大于该阈值后就认为是大图，默认值为：屏幕的宽 * 高 * 4。 | ### setExceedTheLimitBitmapMonitorEnabled ```java public static void setExceedTheLimitBitmapMonitorEnabled(boolean enabled) ``` 设置开启大图监控。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | enabled | boolean | 是否开启大图监控。

`true`：是

`false`：（默认）否

| **注意** 若某张图片命中了多个条件，则将在多个命中维度下上报该条图片数据。 ### setEnableAllSourceUriReport ```java public static void setEnableAllSourceUriReport(boolean enabled) ``` 设置是否上报所有类型的 URI 加载图片。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | enabled | boolean | 是否上报所有类型的 URI 加载图片。

`true`：是

`false`：（默认）否

| **注意** 请您谨慎设置，一般情况下推荐不设置或设置为 `false`。 # BlurHashConfig ```java public final class BlurHashConfig ``` 模糊图占位（Blurhash）相关接口。 ## 成员变量 | 类型 | 默认值 | 名称 | | --- | --- | --- | | int | 100 | [MAX_BLUR_HASH_WIDTH](#BlurHashConfig-max_blur_hash_width) | | int | 100 | [MAX_BLUR_HASH_HEIGHT](#BlurHashConfig-max_blur_hash_height) | | int | 60 | [DEFAULT_BLUR_HASH_SIZE](#BlurHashConfig-default_blur_hash_size) | | float | 1f | [DEFAULT_BLUR_HASH_PUNCH](#BlurHashConfig-default_blur_hash_punch) | ## 成员函数 | 返回 | 名称 | | --- | --- | | BlurHashConfig | [BlurHashConfig](#BlurHashConfig-blurhashconfig) | | BlurHashConfig | [BlurHashConfig](#BlurHashConfig-blurhashconfig-2) | ## 变量说明 ### MAX_BLUR_HASH_WIDTH ```java public static final int MAX_BLUR_HASH_WIDTH = 100 ``` 模糊图宽度的最大值为 100，单位为 px。 ### MAX_BLUR_HASH_HEIGHT ```java public static final int MAX_BLUR_HASH_HEIGHT = 100 ``` 模糊图高度的最大值为 100，单位为 px。 ### DEFAULT_BLUR_HASH_SIZE ```java public static final int DEFAULT_BLUR_HASH_SIZE = 60 ``` 模糊图宽/高的默认值为 60，单位为 px。 ### DEFAULT_BLUR_HASH_PUNCH ```java public static final float DEFAULT_BLUR_HASH_PUNCH = 1f ``` 模糊图对比度默认值为 1f。 ## 函数说明 ### BlurHashConfig ```java public BlurHashConfig( int width, int height ) ``` 设置模糊图宽高大小。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | width | int | 设置模糊图的宽，单位为 px。 | | height | int | 设置模糊图的高，单位为 px。 | **注意** 默认模糊图对比度为 1f，且缓存生成模糊图所需的中间数据。 ### BlurHashConfig ```java public BlurHashConfig( int width, int height, float punch, boolean useCache ) ``` 设置模糊图宽高大小、对比度及是否缓存。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | width | int | 设置模糊图的宽，单位为 px。 | | height | int | 设置模糊图的高，单位为 px。 | | punch | float | 对比度，默认值为 1f。取值需大于 0。 | | useCache | boolean | 是否缓存生成模糊图所需的中间数据。

`true`：是

`false`：否

| # GenericDraweeHierarchy ```java public class GenericDraweeHierarchy ``` 设置和配置 DraweeView 的视觉效果和行为，继承自 `SettableDraweeHierarchy`。支持定义图像加载过程中各个状态的显示样式、占位符、进度条等视觉效果。 - 如果已提供故障图，发生故障时，将使用故障图像。若未提供故障图，将使用占位符。 - 如果已提供重试图像，启用重试失败时，将使用重试图像。 - 如果已提供进度条，将一直显示到完全加载。每个图像都可以指定使用不同的比例显示。 - 支持图层之间的淡入淡出。 - 支持圆角处理。 ## 成员函数 | 返回 | 名称 | | --- | --- | | void | [setFadeDuration](#GenericDraweeHierarchy-setfadeduration) | | int | [getFadeDuration](#GenericDraweeHierarchy-getfadeduration) | | void | [setActualImageFocusPoint](#GenericDraweeHierarchy-setactualimagefocuspoint) | | void | [setActualImageScaleType](#GenericDraweeHierarchy-setactualimagescaletype) | | ScalingUtils.ScaleType | [getActualImageScaleType](#GenericDraweeHierarchy-getactualimagescaletype) | | PointF | [getActualImageFocusPoint](#GenericDraweeHierarchy-getactualimagefocuspoint) | | void | [setActualImageColorFilter](#GenericDraweeHierarchy-setactualimagecolorfilter) | | void | [getActualImageBounds](#GenericDraweeHierarchy-getactualimagebounds) | | void | [setPlaceholderImage](#GenericDraweeHierarchy-setplaceholderimage) | | void | [setPlaceholderImage](#GenericDraweeHierarchy-setplaceholderimage-2) | | boolean | [hasPlaceholderImage](#GenericDraweeHierarchy-hasplaceholderimage) | | void | [setPlaceholderImageFocusPoint](#GenericDraweeHierarchy-setplaceholderimagefocuspoint) | | void | [setPlaceholderImage](#GenericDraweeHierarchy-setplaceholderimage-3) | | void | [setPlaceholderImage](#GenericDraweeHierarchy-setplaceholderimage-4) | | void | [setFailureImage](#GenericDraweeHierarchy-setfailureimage) | | void | [setFailureImage](#GenericDraweeHierarchy-setfailureimage-2) | | void | [setFailureImage](#GenericDraweeHierarchy-setfailureimage-3) | | void | [setFailureImage](#GenericDraweeHierarchy-setfailureimage-4) | | void | [setRetryImage](#GenericDraweeHierarchy-setretryimage) | | void | [setRetryImage](#GenericDraweeHierarchy-setretryimage-2) | | void | [setRetryImage](#GenericDraweeHierarchy-setretryimage-3) | | void | [setRetryImage](#GenericDraweeHierarchy-setretryimage-4) | | void | [setProgressBarImage](#GenericDraweeHierarchy-setprogressbarimage) | | void | [setProgressBarImage](#GenericDraweeHierarchy-setprogressbarimage-2) | | void | [setProgressBarImage](#GenericDraweeHierarchy-setprogressbarimage-3) | | void | [setProgressBarImage](#GenericDraweeHierarchy-setprogressbarimage-4) | | void | [setBackgroundImage](#GenericDraweeHierarchy-setbackgroundimage) | | void | [setOverlayImage](#GenericDraweeHierarchy-setoverlayimage) | | void | [setOverlayImage](#GenericDraweeHierarchy-setoverlayimage-2) | | void | [setRoundingParams](#GenericDraweeHierarchy-setroundingparams) | | RoundingParams | [getRoundingParams](#GenericDraweeHierarchy-getroundingparams) | | void | [setOnFadeFinishedListener](#GenericDraweeHierarchy-setonfadefinishedlistener) | ## 函数说明 ### setFadeDuration ```java public void setFadeDuration(int durationMs) ``` 设置淡入淡出持续时间。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | durationMs | int | 淡入淡出时间，单位为 ms，默认为 0。 | ### getFadeDuration ```java public int getFadeDuration() ``` 获取淡入淡出持续时间。 **返回值** 淡入淡出时间，单位为 ms。 ### setActualImageFocusPoint ```java public void setActualImageFocusPoint(PointF focusPoint) ``` 设置实际图像对焦点。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | focusPoint | PointF | 图像对焦点。 | ### setActualImageScaleType ```java public void setActualImageScaleType(ScalingUtils.ScaleType scaleType) ``` 设置实际图像缩放模式。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | scaleType | ScalingUtils.ScaleType | 缩放模式。 | ### getActualImageScaleType ```java public ScalingUtils.ScaleType getActualImageScaleType() ``` 获取实际图像缩放模式。 **返回值** 图像缩放模式。 ### getActualImageFocusPoint ```java public PointF getActualImageFocusPoint() ``` 获取实际图像对焦点。 **返回值** 图像对焦点。 ### setActualImageColorFilter ```java public void setActualImageColorFilter(ColorFilter colorfilter) ``` 设置应用于实际图像的滤色器。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | colorfilter | ColorFilter | 图像滤色器。 | ### getActualImageBounds ```java public void getActualImageBounds(RectF outBounds) ``` 获取实际图像未执行裁剪缩放时的边界。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | outBounds | RectF | 图像边界。 | ### setPlaceholderImage ```java public void setPlaceholderImage(@Nullable Drawable drawable) ``` 设置占位图。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | drawable | @Nullable Drawable | 占位图。 | ### setPlaceholderImage ```java public void setPlaceholderImage( final Drawable drawable, final ScalingUtils.ScaleType scaleType ) ``` 设置占位图并指定缩放模式。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | drawable | final Drawable | 占位图。 | | scaleType | final ScalingUtils.ScaleType | 缩放模式。 | ### hasPlaceholderImage ```java public boolean hasPlaceholderImage() ``` 是否存在占位图。 - `true`：是 - `false`：否 ### setPlaceholderImageFocusPoint ```java public void setPlaceholderImageFocusPoint(PointF focusPoint) ``` 设置占位图的焦点位置。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | focusPoint | PointF | 占位图的焦点位置 | ### setPlaceholderImage ```java public void setPlaceholderImage(int resourceId) ``` 设置占位图资源 ID。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | resourceId | int | 占位图资源 ID，代表的是一个 Android 的 drawable 资源或者颜色资源。 | ### setPlaceholderImage ```java public void setPlaceholderImage( int resourceId, ScalingUtils.ScaleType scaleType ) ``` 设置占位图资源 ID 并指定缩放模式。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | resourceId | int | 占位图资源 ID，代表的是一个 Android 的 drawable 资源或者颜色资源。 | | scaleType | ScalingUtils.ScaleType | 缩放模式。 | ### setFailureImage ```java public void setFailureImage(@Nullable Drawable drawable) ``` 设置失败时的故障图，当图片加载失败时显示自定义故障图。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | drawable | @Nullable Drawable | 故障图。 | ### setFailureImage ```java public void setFailureImage( Drawable drawable, ScalingUtils.ScaleType scaleType ) ``` 设置失败时的故障图并指定缩放模式。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | drawable | Drawable | 失败时的故障图。 | | scaleType | ScalingUtils.ScaleType | 缩放模式。 | ### setFailureImage ```java public void setFailureImage(int resourceId) ``` 设置失败时的图片资源 ID。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | resourceId | int | 失败时的图片资源 ID。 | ### setFailureImage ```java public void setFailureImage( int resourceId, ScalingUtils.ScaleType scaleType ) ``` 设置失败时的图片资源 ID 并指定缩放模式。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | resourceId | int | 失败时的图片资源 ID。 | | scaleType | ScalingUtils.ScaleType | 缩放模式。 | ### setRetryImage ```java public void setRetryImage(@Nullable Drawable drawable) ``` 设置重试图片。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | drawable | @Nullable Drawable | 重试图片。 | ### setRetryImage ```java public void setRetryImage( Drawable drawable, ScalingUtils.ScaleType scaleType ) ``` 设置重试图片并指定缩放模式。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | drawable | Drawable | 重试图片。 | | scaleType | ScalingUtils.ScaleType | 缩放模式。 | ### setRetryImage ```java public void setRetryImage(int resourceId) ``` 设置重试资源 ID。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | resourceId | int | 重试资源 ID。 | ### setRetryImage ```java public void setRetryImage( int resourceId, ScalingUtils.ScaleType scaleType ) ``` 设置重试资源 ID 并指定缩放模式。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | resourceId | int | 重试资源 ID。 | | scaleType | ScalingUtils.ScaleType | 缩放模式。 | ### setProgressBarImage ```java public void setProgressBarImage(@Nullable Drawable drawable) ``` 设置进度条图片。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | drawable | @Nullable Drawable | 进度条图片。 | ### setProgressBarImage ```java public void setProgressBarImage( Drawable drawable, ScalingUtils.ScaleType scaleType ) ``` 设置进度条图片并指定缩放模式。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | drawable | Drawable | 进度条图片。 | | scaleType | ScalingUtils.ScaleType | 缩放模式。 | ### setProgressBarImage ```java public void setProgressBarImage(int resourceId) ``` 设置进度条资源 ID。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | resourceId | int | 进度条资源 ID。 | ### setProgressBarImage ```java public void setProgressBarImage( int resourceId, ScalingUtils.ScaleType scaleType ) ``` 设置进度条资源 ID 并指定缩放模式。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | resourceId | int | 进度条资源 ID。 | | scaleType | ScalingUtils.ScaleType | 缩放模式。 | ### setBackgroundImage ```java public void setBackgroundImage(@Nullable Drawable drawable) ``` 设置背景图像。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | drawable | @Nullable Drawable | 背景图。 | ### setOverlayImage ```java public void setOverlayImage( int index, @Nullable Drawable drawable ) ``` 在特定的下标位置设置覆盖层图像。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | index | int | 下标值 | | drawable | @Nullable Drawable | 覆盖层图像 | **注意** 用于添加额外的装饰、标记或其他视觉效果。通过设置覆盖层图像，你可以在实际图像上方添加叠加的元素。 ### setOverlayImage ```java public void setOverlayImage(@Nullable Drawable drawable) ``` 设置覆盖层图像。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | drawable | @Nullable Drawable | 覆盖层图像 | **注意** 用于添加额外的装饰、标记或其他视觉效果。通过设置覆盖层图像，你可以在实际图像上方添加叠加的元素。 ### setRoundingParams ```java public void setRoundingParams(@Nullable RoundingParams roundingParams) ``` 设置图像圆角处理。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | roundingParams | @Nullable RoundingParams | 圆角参数，详见 [RoundingParams](#RoundingParams)。 | ### getRoundingParams ```java public RoundingParams getRoundingParams() ``` 获取图像圆角参数。 **返回值** 图像圆角参数。 ### setOnFadeFinishedListener ```java public void setOnFadeFinishedListener(FadeDrawable.OnFadeFinishedListener onFadeFinished) ``` 设置图像淡入淡出结束监听器。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | onFadeFinished | FadeDrawable.OnFadeFinishedListener | 淡入淡出结束监听器。 | # ImagePipelineConfig ```java public class ImagePipelineConfig ``` 图像管道库的主配置类。 ## 静态函数 | 返回 | 名称 | | --- | --- | | static Builder | [newBuilder](#ImagePipelineConfig-newbuilder) | ## 成员函数 | 返回 | 名称 | | --- | --- | | Bitmap.Config | [getBitmapConfig](#ImagePipelineConfig-getbitmapconfig) | ## 函数说明 ### newBuilder ```java public static Builder newBuilder(Context context) ``` 创建一个 `ImagePipelineConfig.Builder` 实例。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | context | Context | 上下文对象。请使用 Application 的 Context 对象，否则可能会有泄漏风险。 | **返回值** 一个 `ImagePipelineConfig.Builder` 的新实例。 ### getBitmapConfig ```java public Bitmap.Config getBitmapConfig() ``` 获取配置的 Bitmap.Config 信息。 **返回值** 配置的 Bitmap.Config 信息。 **注意** 每个进程只能执行一次。示例代码如下： ```java ImagePipelineConfig config = ImagePipelineConfig.newBuilder() .setXXX(xxx) .setYYY(yyy) .build(); ImagePipelineFactory factory = new ImagePipelineFactory(config); ImagePipeline pipeline = factory.getImagePipeline(); ``` # Fresco ```java public class Fresco ``` Fresco 框架的入口类。 ## 静态函数 | 返回 | 名称 | | --- | --- | | static void | [initialize](#Fresco-initialize) | | static void | [initialize](#Fresco-initialize-2) | | static void | [initialize](#Fresco-initialize-3) | | static void | [initialize](#Fresco-initialize-5) | | static void | [initialize](#Fresco-initialize-6) | | static PipelineDraweeControllerBuilder | [newDraweeControllerBuilder](#Fresco-newdraweecontrollerbuilder) | | static ImagePipelineFactory | [getImagePipelineFactory](#Fresco-getimagepipelinefactory) | | static ImagePipeline | [getImagePipeline](#Fresco-getimagepipeline) | | static void | [shutDown](#Fresco-shutdown) | | static boolean | [hasBeenInitialized](#Fresco-hasbeeninitialized) | ## 函数说明 ### initialize ```java public static void initialize(Context context) ``` 使用默认配置初始化 `Fresco`。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | context | Context | 上下文对象。请使用 Application 的 Context 对象，否则可能会有泄漏风险。 | ### initialize ```java public static void initialize( Context context, @Nullable ImagePipelineConfig imagePipelineConfig ) ``` 使用默认的 Drawee 配置初始化 `Fresco`。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | context | Context | 上下文对象。请使用 Application 的 Context 对象，否则可能会有泄漏风险。 | | imagePipelineConfig | @Nullable ImagePipelineConfig | 图片管道配置，详见 [ImagePipelineConfig](#ImagePipelineConfig)。 | ### initialize ```java public static void initialize( Context context, @Nullable IImagePipelineConfig iImagePipelineConfig ) ``` 使用默认的 Drawee 配置初始化 `Fresco`。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | context | Context | 上下文对象。请使用 Application 的 Context 对象，否则可能会有泄漏风险。 | | iImagePipelineConfig | @Nullable IImagePipelineConfig | 图片管道配置，详见 [ImagePipelineConfig](#ImagePipelineConfig)。 | ### initialize ```java public static void initialize( Context context, @Nullable ImagePipelineConfig imagePipelineConfig, @Nullable DraweeConfig draweeConfig ) ``` 使用自定义配置初始化 `Fresco`。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | context | Context | 上下文对象。请使用 Application 的 Context 对象，否则可能会有泄漏风险。 | | imagePipelineConfig | @Nullable ImagePipelineConfig | 图片管道配置，详见 [ImagePipelineConfig](#ImagePipelineConfig)。 | | draweeConfig | @Nullable DraweeConfig | Drawee 配置。 | ### initialize ```java public static void initialize( Context context, @Nullable ImagePipelineConfig imagePipelineConfig, @Nullable DraweeConfig draweeConfig, boolean useNativeCode ) ``` 使用自定义配置初始化 `Fresco`。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | context | Context | 上下文对象。请使用 Application 的 Context 对象，否则可能会有泄漏风险。 | | imagePipelineConfig | @Nullable ImagePipelineConfig | 图片管道配置，详见 [ImagePipelineConfig](#ImagePipelineConfig)。 | | draweeConfig | @Nullable DraweeConfig | Drawee 配置。 | | useNativeCode | boolean | 是否使用 native 代码。

`true`：是

`false`：否

| ### newDraweeControllerBuilder ```java public static PipelineDraweeControllerBuilder newDraweeControllerBuilder() ``` 获取 `PipelineDraweeControllerBuilder` 的新实例。 **返回值** 一个新的 Fresco Drawee controller builder 实例。 ### getImagePipelineFactory ```java public static ImagePipelineFactory getImagePipelineFactory() ``` 获取 `ImagePipelineFactory` 的实例。 **返回值** `ImagePipelineFactory` 实例。 ### getImagePipeline ```java public static ImagePipeline getImagePipeline() ``` 获取 `ImagePipeline` 的实例。 **返回值** `ImagePipeline` 实例。 ### shutDown ```java public static void shutDown() ``` 关闭 `Fresco`。 **注意** 当您不再使用 `Fresco` 的时候，请调用此方法。 ### hasBeenInitialized ```java public static boolean hasBeenInitialized() ``` 判断是否已初始化 `Fresco`。 - `true`：是 - `false`：否 **返回值** 判断结果。 **注意** 使用前您必须先初始化此类。最简单的方式是使用 `Fresco.initialize(Context)` 来进行初始化。 # SimpleDraweeView ```java public class SimpleDraweeView ``` URI 图片视图。该视图接受 URI 作为输入，并在内部生成和设置控制器。 ## 静态函数 | 返回 | 名称 | | --- | --- | | static void | [initialize](#SimpleDraweeView-initialize) | | static void | [initialize](#SimpleDraweeView-initialize-2) | ## 成员函数 | 返回 | 名称 | | --- | --- | | void | [setImageURI](#SimpleDraweeView-setimageuri) | | void | [setImageURI](#SimpleDraweeView-setimageuri-2) | | void | [setImageURI](#SimpleDraweeView-setimageuri-3) | | void | [setImageURI](#SimpleDraweeView-setimageuri-4) | | void | [setController](#SimpleDraweeView-setcontroller) | | void | [setImageURI](#SimpleDraweeView-setimageuri-5) | | void | [setImageURI](#SimpleDraweeView-setimageuri-6) | | void | [setImageURI](#SimpleDraweeView-setimageuri-7) | | void | [setImageURI](#SimpleDraweeView-setimageuri-8) | | void | [setImageURI](#SimpleDraweeView-setimageuri-9) | | void | [setImageURI](#SimpleDraweeView-setimageuri-10) | | void | [setActualImageResource](#SimpleDraweeView-setactualimageresource) | | void | [setActualImageResource](#SimpleDraweeView-setactualimageresource-2) | | Uri | [getImageUri](#SimpleDraweeView-getimageuri) | ## 函数说明 ### initialize ```java public static void initialize(Supplier draweeControllerBuilderSupplier) ``` 使用 ControllerBuilderSupplier 初始化 Drawee 框架。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | draweeControllerBuilderSupplier | Supplier | Supplier 对象，用于提供 Drawee 的 ControllerBuilderSupplier。 | ### initialize ```java public static void initialize(IAbstractDraweeControllerBuilder iDraweeControllerBuilderSupplier) ``` 使用 controller builders 来初始化 Drawee 框架。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | iDraweeControllerBuilderSupplier | IAbstractDraweeControllerBuilder | 实现了 IAbstractDraweeControllerBuilder 接口的对象，用于提供 Drawee 的 controller builders。 | ### setImageURI ```java public void setImageURI(Uri uri) ``` 设置加载图片地址。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | uri | Uri | 图片 URI 对象。 | ### setImageURI ```java public void setImageURI(@Nullable String uriString) ``` 设置加载图片 URI 字符串。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | uriString | @Nullable String | 图片 URI 字符串。 | ### setImageURI ```java public void setImageURI( @Nullable String uriString, String blurHash, BlurHashConfig blurHashConfig ) ``` 设置加载本地模糊图。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | uriString | @Nullable String | 图片 URI 字符串。 | | blurHash | String | 图片的 blurhash 码。参考[获取图片 BlurHash 码](https://www.volcengine.com/docs/508/1230997)文档，了解如何获取指定图片的 BlurHash 码（模糊图）。 | | blurHashConfig | BlurHashConfig | 图片的 blurhash 配置，详见 [BlurHashConfig](#BlurHashConfig)。 | ### setImageURI ```java public void setImageURI( Uri uri, String blurHash, BlurHashConfig blurHashConfig ) ``` 设置加载本地模糊图。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | uri | Uri | 图片 URI 对象。 | | blurHash | String | 图片的 blurhash 码。参考[获取图片 BlurHash 码](https://www.volcengine.com/docs/508/1230997)文档，了解如何获取指定图片的 BlurHash 码（模糊图）。 | | blurHashConfig | BlurHashConfig | 图片的 blurhash 配置，详见 [BlurHashConfig](#BlurHashConfig)。 | ### setController ```java public void setController( @Nullable DraweeController draweeController, String blurHash, BlurHashConfig blurHashConfig ) ``` 设置图片 Drawee 控制器，并指定模糊图占位（blurhash）相关配置。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | draweeController | @Nullable DraweeController | Drawee 控制器。 | | blurHash | String | blurhash 码。参考[获取图片 BlurHash 码](https://www.volcengine.com/docs/508/1230997)文档，了解如何获取指定图片的 BlurHash 码（模糊图）。 | | blurHashConfig | BlurHashConfig | blurhash 配置。详见 [BlurHashConfig](#BlurHashConfig)。 | ### setImageURI ```java public void setImageURI( Uri uri, @Nullable Object callerContext, boolean isEnableHeaderBlurhash ) ``` 加载网络下发模糊图（blurhash）。在弱网情况下，客户端将根据图片请求 URL 中响应头携带的 BlurHash 字段，首先加载模糊图。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | uri | Uri | 图片访问 URL。该地址需携带开启了[模糊图占位](https://www.volcengine.com/docs/508/8087#%E7%BC%96%E8%BE%91%E6%A8%A1%E6%9D%BF)的图片处理模板配置信息。例如：`https://test.net/tos-cn-i-serviceid/demo.jpg~tplv-ut**ti-blurhash.jpg` | | callerContext | @Nullable Object | 请求上下文。 | | isEnableHeaderBlurhash | boolean | 是否开启获取网络下发的 blurhash 码。

`true`：是

`false`：否

| **注意** 如果模板中配置了图像处理（缩放、水印）等或图像压缩，则将以图像处理&压缩后的结果图去生成 blurhash 码。 ### setImageURI ```java public void setImageURI( Uri uri, @Nullable Object callerContext ) ``` 设置图片加载地址。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | uri | Uri | 图片 URI 对象。 | | callerContext | @Nullable Object | 请求上下文。 | ### setImageURI ```java public void setImageURI( @Nullable String uriString, @Nullable Object callerContext ) ``` 设置图片加载地址。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | uriString | @Nullable String | 图片 URI 字符串。 | | callerContext | @Nullable Object | 请求上下文。 | ### setImageURI ```java void setImageURI( @Nullable String uriString, String publicKey, String urlKey ) ``` 加载加密图片。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | uriString | @Nullable String | 图片访问 URL。 | | publicKey | String | 公钥。您在 veImageX 控制台获取的[数据加密密钥](https://www.volcengine.com/docs/508/735219#%E7%94%B3%E8%AF%B7%E5%8A%A0%E5%AF%86%E5%AF%86%E9%92%A5)，用于解密 `urlKey`。 | | urlKey | String | 对称密钥。您在上传 SDK 用于加密文件的[加密密钥](https://www.volcengine.com/docs/508/148789)，用于解密加密图片。 | ### setImageURI ```java void setImageURI( Uri uri, String publicKey, String urlKey ) ``` 加载加密图片。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | uri | Uri | URI 对象。 | | publicKey | String | 公钥。您在 veImageX 控制台获取的[数据加密密钥](https://www.volcengine.com/docs/508/735219#%E7%94%B3%E8%AF%B7%E5%8A%A0%E5%AF%86%E5%AF%86%E9%92%A5)，用于解密 `urlKey`。 | | urlKey | String | 对称密钥。您在上传 SDK 用于加密文件的[加密密钥](https://www.volcengine.com/docs/508/148789)，用于解密加密图片。 | ### setImageURI ```java void setImageURI( Uri uri, String publicKey, String urlKey, @Nullable Object callerContext ) ``` 加载加密图片。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | uri | Uri | URI 对象。 | | publicKey | String | 公钥。您在 veImageX 控制台获取的[数据加密密钥](https://www.volcengine.com/docs/508/735219#%E7%94%B3%E8%AF%B7%E5%8A%A0%E5%AF%86%E5%AF%86%E9%92%A5)，用于解密 `urlKey`。 | | urlKey | String | 对称密钥。您在上传 SDK 用于加密文件的[加密密钥](https://www.volcengine.com/docs/508/148789)，用于解密加密图片。 | | callerContext | @Nullable Object | 请求上下文。 | ### setActualImageResource ```java public void setActualImageResource(@DrawableRes int resourceId) ``` 将实际图像资源设置为给定的资源 ID。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | resourceId | @DrawableRes int | 资源 ID。 | **注意** 与 setImageResource 类似，会将显示的图像设置为给定的资源。但是，setImageResource 绕过了所有 Drawee 功能并使视图充当普通的 ImageView，而此方法保留了所有 Drawee 功能，包括 DraweeHierarchy。 ### setActualImageResource ```java public void setActualImageResource( @DrawableRes int resourceId, @Nullable Object callerContext ) ``` 将实际图像资源设置为给定的资源 ID。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | resourceId | @DrawableRes int | 可绘制对象的资源 ID。 | | callerContext | @Nullable Object | 请求上下文。 | **注意** 与 setImageResource 类似，会将显示的图像设置为给定的资源。但是，setImageResource 绕过了所有 Drawee 功能并使视图充当普通的 ImageView。而此方法保留了所有 Drawee 功能，包括 DraweeHierarchy。 ### getImageUri ```java public Uri getImageUri() ``` 获取请求的图片 URI。 **返回值** 图片 URI。 **注意** 必须静态初始化此类才能使用。如果您使用的是 Fresco 图像管道，使用 [initialize](#Fresco-initialize) 执行此操作。 # PipelineDraweeController ```java public class PipelineDraweeController ``` Drawee 控制器，用于将图像管道（Pipeline）与 SettableDraweeHierarchy 桥接。 ## 成员函数 | 返回 | 名称 | | --- | --- | | void | [initialize](#PipelineDraweeController-initialize) | ## 函数说明 ### initialize ```java public void initialize( Supplier>> dataSourceSupplier, String id, CacheKey cacheKey, Object callerContext, @Nullable ImmutableList< DrawableFactory> customDrawableFactories, @Nullable ImageOriginListener imageOriginListener ) ``` 初始化控制器并设置相关参数。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | dataSourceSupplier | Supplier\>> | 数据源供应者，用于提供数据源 (DataSource) 获取图像。 | | id | String | 控制器的唯一 ID，用于标识该控制器。 | | cacheKey | CacheKey | 缓存键。 | | callerContext | Object | 控制器的标记和上下文。 | | customDrawableFactories | @Nullable ImmutableList\ | 为给定的图片创建 Drawable 的工厂列表。 | | imageOriginListener | @Nullable ImageOriginListener | 图像来源监听器。 | **注意** hierarchy 的实际图像被设置给所提供数据源获取的图像。根据 attach/detach 调用自动获取和关闭数据源。 # RoundingParams ```java public class RoundingParams ``` 图片圆角处理相关接口，您可通过相关配置将矩形图片的 4 个角切成圆角。 ## 静态函数 | 返回 | 名称 | | --- | --- | | static RoundingParams | [asCircle](#RoundingParams-ascircle) | | static RoundingParams | [fromCornersRadius](#RoundingParams-fromcornersradius) | | static RoundingParams | [fromCornersRadii](#RoundingParams-fromcornersradii) | | static RoundingParams | [fromCornersRadii](#RoundingParams-fromcornersradii-2) | ## 成员函数 | 返回 | 名称 | | --- | --- | | RoundingParams | [setRoundAsCircle](#RoundingParams-setroundascircle) | | boolean | [getRoundAsCircle](#RoundingParams-getroundascircle) | | RoundingParams | [setCornersRadius](#RoundingParams-setcornersradius) | | RoundingParams | [setCornersRadii](#RoundingParams-setcornersradii) | | RoundingParams | [setCornersRadii](#RoundingParams-setcornersradii-2) | | float[] | [getCornersRadii](#RoundingParams-getcornersradii) | | RoundingParams | [setRoundingMethod](#RoundingParams-setroundingmethod) | | RoundingMethod | [getRoundingMethod](#RoundingParams-getroundingmethod) | | RoundingParams | [setOverlayColor](#RoundingParams-setoverlaycolor) | | int | [getOverlayColor](#RoundingParams-getoverlaycolor) | | RoundingParams | [setBorderWidth](#RoundingParams-setborderwidth) | | float | [getBorderWidth](#RoundingParams-getborderwidth) | | RoundingParams | [setBorderColor](#RoundingParams-setbordercolor) | | int | [getBorderColor](#RoundingParams-getbordercolor) | | RoundingParams | [setBorder](#RoundingParams-setborder) | | RoundingParams | [setPadding](#RoundingParams-setpadding) | | float | [getPadding](#RoundingParams-getpadding) | | RoundingParams | [setScaleDownInsideBorders](#RoundingParams-setscaledowninsideborders) | | boolean | [getScaleDownInsideBorders](#RoundingParams-getscaledowninsideborders) | | RoundingParams | [setPaintFilterBitmap](#RoundingParams-setpaintfilterbitmap) | | boolean | [getPaintFilterBitmap](#RoundingParams-getpaintfilterbitmap) | ## 函数说明 ### asCircle ```java public static RoundingParams asCircle() ``` 创建`RoundingParams`实例对象，并设置图像显示为圆形。 **返回值** `RoundingParams`实例对象。 ### fromCornersRadius ```java public static RoundingParams fromCornersRadius(float radius) ``` 创建`RoundingParams`实例对象，并设置同时应用于图像四个角的圆角半径。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | radius | float | 圆角半径，单位为 px。 | **返回值** `RoundingParams`实例对象。 ### fromCornersRadii ```java public static RoundingParams fromCornersRadii( float topLeft, float topRight, float bottomRight, float bottomLeft ) ``` 创建`RoundingParams`实例对象，并单独设置图像四个角的圆角半径。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | topLeft | float | 左上角的圆角半径，单位为 px。 | | topRight | float | 右上角的圆角半径，单位为 px。 | | bottomRight | float | 右下角的圆角半径，单位为 px。 | | bottomLeft | float | 左下角的圆角半径，单位为 px。 | **返回值** `RoundingParams`实例对象。 ### fromCornersRadii ```java public static RoundingParams fromCornersRadii(float[] radii) ``` 创建`RoundingParams`实例对象，并设置图像四个角的圆角半径数组。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | radii | float[] | 圆角半径数组，单位为 px。数组长度固定为 8，每两个值依次决定一个圆角，顺序依次为左上、右上、右下、左下。例如：`{10.0f, 10.0f, 20.0f, 20.0f, 30.0f, 30.0f, 40.0f, 40.0f}` | **返回值** `RoundingParams`实例对象。 **注意** 圆角半径数组的长度必须为 8，否则将抛`IllegalArgumentException`异常。 ### setRoundAsCircle ```java public RoundingParams setRoundAsCircle(boolean roundAsCircle) ``` 设置图像显示为圆形。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | roundAsCircle | boolean | 是否设置图像显示为圆形。

`true`：是

`false`：否

| **返回值** 更改后的圆角参数实例对象。 ### getRoundAsCircle ```java public boolean getRoundAsCircle() ``` 图像是否被设置为圆形显示。 - `true`：是 - `false`：否 **返回值** 判断结果。 ### setCornersRadius ```java public RoundingParams setCornersRadius(float radius) ``` 设置同时应用于四个角的圆角半径。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | radius | float | 圆角半径，单位为 px。 | **返回值** 更新后的`RoundingParams`实例。 ### setCornersRadii ```java public RoundingParams setCornersRadii( float topLeft, float topRight, float bottomRight, float bottomLeft ) ``` 设置图像四个角的圆角圆角半径。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | topLeft | float | 左上角的圆角半径，单位为 px。 | | topRight | float | 右上角的圆角半径，单位为 px。 | | bottomRight | float | 右下角的圆角半径，单位为 px。 | | bottomLeft | float | 左下角的圆角半径，单位为 px。 | **返回值** 更新后的`RoundingParams`实例。 ### setCornersRadii ```java public RoundingParams setCornersRadii(float[] radii) ``` 设置图像四个角的圆角半径数组。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | radii | float[] | 圆角半径数组，单位为 px。数组长度固定为 8，每两个值依次决定一个圆角，顺序依次为左上、右上、右下、左下。例如：`{10.0f, 10.0f, 20.0f, 20.0f, 30.0f, 30.0f, 40.0f, 40.0f}` | **返回值** 更新后的`RoundingParams`实例。 ### getCornersRadii ```java public float[] getCornersRadii() ``` 获取图像的圆角半径数组，单位为 px。每两个值依次决定一个圆角，顺序依次为左上、右上、右下、左下。 **返回值** 圆角半径数组 [setCornersRadii](#RoundingParams-setcornersradii-2)。 ### setRoundingMethod ```java public RoundingParams setRoundingMethod(RoundingMethod roundingMethod) ``` 设置圆角处理方式。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | roundingMethod | RoundingMethod | 圆角处理方式，详见 [RoundingMethod](1262421#RoundingMethod)。 | **返回值** 更新后的`RoundingParams`实例。 ### getRoundingMethod ```java public RoundingMethod getRoundingMethod() ``` 获取圆角处理方式。 **返回值** 圆角处理方式，详见 [RoundingMethod](1262421#RoundingMethod)。 ### setOverlayColor ```java public RoundingParams setOverlayColor(@ColorInt int overlayColor) ``` 设置覆盖颜色，并将方法更改为 [OVERLAY_COLOR](1262421#RoundingMethod)。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | overlayColor | @ColorInt int | 颜色资源 ID | **返回值** 更改后的`RoundingParams`实例。 ### getOverlayColor ```java public int getOverlayColor() ``` 获取覆盖颜色。 **返回值** 覆盖颜色。 ### setBorderWidth ```java public RoundingParams setBorderWidth(float width) ``` 设置边界宽。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | width | float | 边界宽 | **返回值** 更改后的`RoundingParams`实例。 ### getBorderWidth ```java public float getBorderWidth() ``` 获取边界宽。 **返回值** 边界宽 ### setBorderColor ```java public RoundingParams setBorderColor(@ColorInt int color) ``` 设置圆角图片的边界颜色。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | color | @ColorInt int | 边界颜色 | **返回值** 更改后的`RoundingParams`实例。 ### getBorderColor ```java public int getBorderColor() ``` 获取圆角图片的边界颜色。 **返回值** 边界颜色 ### setBorder ```java public RoundingParams setBorder( @ColorInt int color, float width ) ``` 同时设置圆角图片边界的宽度和颜色。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | color | @ColorInt int | 边界颜色 | | width | float | 边界宽度 | **返回值** 更改后的`RoundingParams`实例 ### setPadding ```java public RoundingParams setPadding(float padding) ``` 在圆形 drawable 上设置内边距。仅适用于 [BITMAP_ONLY](https://www.volcengine.com/docs/508/1262421#roundingmethod)。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | padding | float | 内边距，单位为 px。 | **返回值** 更改后的`RoundingParams`实例 ### getPadding ```java public float getPadding() ``` 获取在圆形 drawable 上设置的内边距。 **返回值** 内边距 ### setScaleDownInsideBorders ```java public RoundingParams setScaleDownInsideBorders(boolean scaleDownInsideBorders) ``` 设置是否应在边框内缩小图像。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | scaleDownInsideBorders | boolean | 是否应在边框内缩小图像。

`true`：是

`false`：（默认）否

| **返回值** 圆形 drawable 上设置的内边距 ### getScaleDownInsideBorders ```java public boolean getScaleDownInsideBorders() ``` 获取是否应在边框内缩小图像。 - `true`：是 - `false`：否 **返回值** 是否应在边框内缩小图像 ### setPaintFilterBitmap ```java public RoundingParams setPaintFilterBitmap(boolean paintFilterBitmap) ``` 给 `Paint` 设置 `FILTER_BITMAP_FLAG` 标志位。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | paintFilterBitmap | boolean | 是否给 `Paint` 设置 `FILTER_BITMAP_FLAG` 标志位。

`true`：是

`false`：否

| **返回值** 更改后的`RoundingParams`实例。 **注意** 在绘制位图时，通常应启用此功能。除非性能受限（渲染到软件画布）或在大幅缩放时更喜欢像素化伪影而不是模糊时才考虑不启用该能力。 ### getPaintFilterBitmap ```java public boolean getPaintFilterBitmap() ``` 查询 `Paint` 是否设置了 `FILTER_BITMAP_FLAG` 标志位。 - `true`：是 - `false`：否 **返回值** 查询结果。 **注意** 如果没有设置 `FILTER_BITMAP_FLAG` 双线性采样标志位，那么缩放的位图将使用最近邻采样绘制，这可能会导致伪影。在绘制位图时，通常应启用此功能。 # CloudControl ```java public final class CloudControl ``` 云控相关接口。云控相关配置说明，详见 [SDK 配置下发](https://www.volcengine.com/docs/508/65940)。 ## 静态函数 | 返回 | 名称 | | --- | --- | | static CloudControl | [getInstance](#CloudControl-getinstance) | | static void | [init](#CloudControl-init) | | static void | [addCallback](#CloudControl-addcallback) | | static boolean | [isHttp2Enabled](#CloudControl-ishttp2enabled) | | static boolean | [isHttpDnsEnabled](#CloudControl-ishttpdnsenabled) | | static boolean | [isEnableDnsPrefer](#CloudControl-isenablednsprefer) | | static String | [getHttpDnsAddr](#CloudControl-gethttpdnsaddr) | | static int | [getHttpDnsTimeOut](#CloudControl-gethttpdnstimeout) | | static int | [getLocalDnsTimeOut](#CloudControl-getlocaldnstimeout) | | static boolean | [isH2SessionCheckEnable](#CloudControl-ish2sessioncheckenable) | | static int | [getH2SessionCheckInterval](#CloudControl-geth2sessioncheckinterval) | | static boolean | [isPingKeepaliveEnabled](#CloudControl-ispingkeepaliveenabled) | | static int | [getPingKeepaliveInterval](#CloudControl-getpingkeepaliveinterval) | | static String | [getPingKeepaliveHosts](#CloudControl-getpingkeepalivehosts) | | static int | [getPingProbeTimeout](#CloudControl-getpingprobetimeout) | | static String | [getSessionCheckHosts](#CloudControl-getsessioncheckhosts) | | static String | [getCloudControlConfig](#CloudControl-getcloudcontrolconfig) | | static String | [getTTNetConfig](#CloudControl-getttnetconfig) | | static int | [getFailedRetryCount](#CloudControl-getfailedretrycount) | | static int | [getHttpDefaultTimeOut](#CloudControl-gethttpdefaulttimeout) | ## 函数说明 ### getInstance ```java public static CloudControl getInstance() ``` 获取云控实例。 **返回值** 云控实例 ### init ```java public static void init(InitConfig initConfig) ``` 初始化云控。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | initConfig | InitConfig | 云控初始化配置类。 | ### addCallback ```java public static void addCallback(Callback callback) ``` 添加云控回调。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | callback | Callback | 云控回调接口对象。 | ### isHttp2Enabled ```java public static boolean isHttp2Enabled() ``` 云控是否开启了 http 2.0 开关。 - `true`：开启 - `false`：关闭 **返回值** ture 开启了http 2.0。 ### isHttpDnsEnabled ```java public static boolean isHttpDnsEnabled() ``` 云控是否开启了 httpdns 开关。 - `true`：开启 - `false`：关闭 **返回值** ture 开启了http Dns。 ### isEnableDnsPrefer ```java public static boolean isEnableDnsPrefer() ``` 云控是否开启了 ttnet_http_dns_prefer（httpdns 优先）开关。 - `true`：开启 - `false`：关闭 ### getHttpDnsAddr ```java public static String getHttpDnsAddr() ``` 获取云控中的 http_dns_addr（httpdns 域名列表）配置。 ### getHttpDnsTimeOut ```java public static int getHttpDnsTimeOut() ``` 获取云控中的 ttnet_http_dns_timeout（httpdns 超时时间）配置。 ### getLocalDnsTimeOut ```java public static int getLocalDnsTimeOut() ``` 获取云控中的 ttnet_local_dns_time_out（localdns 超时时间）配置。 ### isH2SessionCheckEnable ```java public static boolean isH2SessionCheckEnable() ``` 云控是否开启了 h2_session_check_enabled 开关。 - `true`：开启 - `false`：关闭 ### getH2SessionCheckInterval ```java public static int getH2SessionCheckInterval() ``` 获取云控中的 h2_session_check_interval（HTTP2 session check 时间间隔）配置。 ### isPingKeepaliveEnabled ```java public static boolean isPingKeepaliveEnabled() ``` 云控是否开启了 ping_keepalive_enabled 开关。 - `true`：开启 - `false`：关闭 ### getPingKeepaliveInterval ```java public static int getPingKeepaliveInterval() ``` 获取云控中的 ping_keepalive_interval（HTTP2 ping 保活时间间隔）配置。 ### getPingKeepaliveHosts ```java public static String getPingKeepaliveHosts() ``` 获取云控中的 ping_keepalive_host（开启 HTTP2 策略的域名列表）配置。 ### getPingProbeTimeout ```java public static int getPingProbeTimeout() ``` 获取云控中的 ping_probe_timeout（HTTP2 ping 帧链接探测超时时间）配置。 ### getSessionCheckHosts ```java public static String getSessionCheckHosts() ``` 获取云控中的 session_check_hosts（开启 h2 session check 的域名（+端口）列表）配置。 ### getCloudControlConfig ```java public static String getCloudControlConfig() ``` 获取云控中配置的所有参数。 ### getTTNetConfig ```java public static String getTTNetConfig() ``` 获取云控中配置的 TTNet 配置参数。 ### getFailedRetryCount ```java public static int getFailedRetryCount() ``` 获取云控中配置的失败重试次数。 ### getHttpDefaultTimeOut ```java public static int getHttpDefaultTimeOut() ``` 获取云控中配置的 http 请求超时时长。 # InitConfig ```java public final class InitConfig ``` 云控初始化配置类。 ## 成员变量 | 类型 | 默认值 | 名称 | | --- | --- | --- | | int | 1 | [CHINA](#InitConfig-china) | ## 成员函数 | 返回 | 名称 | | --- | --- | | InitConfig | [InitConfig](#InitConfig-initconfig) | | InitConfig | [InitConfig](#InitConfig-initconfig-2) | | InitConfig | [InitConfig](#InitConfig-initconfig-3) | | InitConfig | [InitConfig](#InitConfig-initconfig-4) | ## 变量说明 ### CHINA ```java public static final int CHINA = 1 ``` 中国。 ## 函数说明 ### InitConfig ```java public InitConfig( @NonNull final Application context, @NonNull final String aid, @NonNull final String appName, @NonNull final String channel, @NonNull final String versionName, @NonNull final String versionCode, @NonNull final String deviceId, final int uriConfig, @Nullable final String token, @Nullable final List encodedAuthCode ) ``` 云控配置类构造函数。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | context | @NonNull final Application | Application 对象。 | | aid | @NonNull final String | 应用 ID，请登录控制台[我的应用](https://console.volcengine.com/imagex/sdk/app/)获取。通过 AppID 可以拉取指定该应用的云控配置，比如客户端日志采样率、网络优化参数等。 | | appName | @NonNull final String | App 名称，根据实际业务填写，用于统计使用。 | | channel | @NonNull final String | 渠道标识，根据实际业务填写。用于区分统计不同渠道来源的图片服务质量数据，如传入 huawei、oppo 等不同渠道标识。 | | versionName | @NonNull final String | App 版本号，根据实际业务填写，主要用于数据统计与配置拉取。 | | versionCode | @NonNull final String | App 版本 code，根据实际业务填写，主要用于数据统计与配置拉取。 | | deviceId | @NonNull final String | 设备 ID，根据实际业务填写，设备的唯一编号，用于统计区分使用。 | | uriConfig | final int | 地区，根据实际业务填写。如果 App 为非中国区域用户服务，则需修改设置为海外，采样后的日志则自动上报到海外地区。 | | token | @Nullable final String | token，请如实填写，您可通过[应用管理](https://www.volcengine.com/docs/508/624617#%E6%9F%A5%E7%9C%8B%E5%BA%94%E7%94%A8%E8%AF%A6%E6%83%85)获取该账号唯一的 Token 值。 | | encodedAuthCode | @Nullable final List\ | 授权码，请如实填写，您可通过 [License 授权管理](https://www.volcengine.com/docs/508/1129796)获取购买 License 后下载至本地的授权码。

\ |||:::warning \ |||建议您在授权码到期前完成[续期](https://www.volcengine.com/docs/508/1129796#%E7%BB%AD%E6%9C%9F-license)操作，并在 SDK 中及时更新为最新授权码，以免影响您的业务使用。
\ |||::: \ ||| | ### InitConfig ```java public InitConfig( @NonNull final Application context, @NonNull final String aid, @NonNull final String appName, @NonNull final String channel, @NonNull final String versionName, @NonNull final String versionCode, @NonNull final String deviceId, final int uriConfig, @Nullable final String token, @Nullable final List encodedAuthCode, boolean enableAddRequestHeader ) ``` 云控配置类构造函数。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | context | @NonNull final Application | Application 对象。 | | aid | @NonNull final String | 应用 ID，请登录控制台[我的应用](https://console.volcengine.com/imagex/sdk/app/)获取。通过 AppID 可以拉取指定该应用的云控配置，比如客户端日志采样率、网络优化参数等。 | | appName | @NonNull final String | App 名称，根据实际业务填写，用于统计使用。 | | channel | @NonNull final String | 渠道标识，根据实际业务填写。用于区分统计不同渠道来源的图片服务质量数据，如传入 huawei、oppo 等不同渠道标识。 | | versionName | @NonNull final String | App 版本号，根据实际业务填写，主要用于数据统计与配置拉取。 | | versionCode | @NonNull final String | App 版本 code，根据实际业务填写，主要用于数据统计与配置拉取。 | | deviceId | @NonNull final String | 设备 ID，根据实际业务填写，设备的唯一编号，用于统计区分使用。 | | uriConfig | final int | 地区，根据实际业务填写。如果 App 为非中国区域用户服务，则需修改设置为海外，采样后的日志则自动上报到海外地区。 | | token | @Nullable final String | token，请如实填写，您可通过[应用管理](https://www.volcengine.com/docs/508/624617#%E6%9F%A5%E7%9C%8B%E5%BA%94%E7%94%A8%E8%AF%A6%E6%83%85)获取该账号唯一的 Token 值。 | | encodedAuthCode | @Nullable final List\ | 授权码，请如实填写，您可通过 [License 授权管理](https://www.volcengine.com/docs/508/1129796)获取购买 License 后下载至本地的授权码。

\ |||:::warning \ |||建议您在授权码到期前完成[续期](https://www.volcengine.com/docs/508/1129796#%E7%BB%AD%E6%9C%9F-license)操作，并在 SDK 中及时更新为最新授权码，以免影响您的业务使用。
\ |||::: \ ||| | | enableAddRequestHeader | boolean | 是否启用添加请求标头。

`true`：是

`false`：否

| ### InitConfig ```java public InitConfig( @NonNull final Application context, @NonNull final String aid, @NonNull final String appName, @NonNull final String channel, @NonNull final String versionName, @NonNull final String versionCode, @NonNull final String deviceId, final int uriConfig, @Nullable final String token, @Nullable final List encodedAuthCode, boolean enableAddRequestHeader, boolean needSetCookieHandler ) ``` 云控配置类构造函数。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | context | @NonNull final Application | Application 对象。 | | aid | @NonNull final String | 应用 ID，请登录控制台[我的应用](https://console.volcengine.com/imagex/sdk/app/)获取。通过 AppID 可以拉取指定该应用的云控配置，比如客户端日志采样率、网络优化参数等。 | | appName | @NonNull final String | App 名称，根据实际业务填写，用于统计使用。 | | channel | @NonNull final String | 渠道标识，根据实际业务填写。用于区分统计不同渠道来源的图片服务质量数据，如传入 huawei、oppo 等不同渠道标识。 | | versionName | @NonNull final String | App 版本号，根据实际业务填写，主要用于数据统计与配置拉取。 | | versionCode | @NonNull final String | App 版本 code，根据实际业务填写，主要用于数据统计与配置拉取。 | | deviceId | @NonNull final String | 设备 ID，根据实际业务填写，设备的唯一编号，用于统计区分使用。 | | uriConfig | final int | 地区，根据实际业务填写。如果 App 为非中国区域用户服务，则需修改设置为海外，采样后的日志则自动上报到海外地区。 | | token | @Nullable final String | token，请如实填写，您可通过[应用管理](https://www.volcengine.com/docs/508/624617#%E6%9F%A5%E7%9C%8B%E5%BA%94%E7%94%A8%E8%AF%A6%E6%83%85)获取该账号唯一的 Token 值。 | | encodedAuthCode | @Nullable final List\ | 授权码，请如实填写，您可通过 [License 授权管理](https://www.volcengine.com/docs/508/1129796)获取购买 License 后下载至本地的授权码。

\ |||:::warning \ |||建议您在授权码到期前完成[续期](https://www.volcengine.com/docs/508/1129796#%E7%BB%AD%E6%9C%9F-license)操作，并在 SDK 中及时更新为最新授权码，以免影响您的业务使用。
\ |||::: \ ||| | | enableAddRequestHeader | boolean | 是否启用添加请求标头。

`true`：是

`false`：否

| | needSetCookieHandler | boolean | 是否设置 Cookie 处理。

`true`：是

`false`：否

| ### InitConfig ```java public InitConfig( @NonNull Application context, @NonNull String aid, @NonNull String appName, @NonNull String channel, @NonNull String versionName, @NonNull String versionCode, @NonNull String deviceId, int uriConfig ) ``` 云控配置类构造函数。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | context | @NonNull Application | Application 对象。 | | aid | @NonNull String | 应用 ID，请登录控制台[我的应用](https://console.volcengine.com/imagex/sdk/app/)获取。通过 AppID 可以拉取指定该应用的云控配置，比如客户端日志采样率、网络优化参数等。 | | appName | @NonNull String | App 名称，根据实际业务填写，用于统计使用。 | | channel | @NonNull String | 渠道标识，根据实际业务填写。用于区分统计不同渠道来源的图片服务质量数据，如传入 huawei、oppo 等不同渠道标识。 | | versionName | @NonNull String | App 版本号，根据实际业务填写，主要用于数据统计与配置拉取。 | | versionCode | @NonNull String | App 版本 code，根据实际业务填写，主要用于数据统计与配置拉取。 | | deviceId | @NonNull String | 设备 ID，根据实际业务填写，设备的唯一编号，用于统计区分使用。 | | uriConfig | int | 地区，根据实际业务填写。如果 App 为非中国区域用户服务，则需修改设置为海外，采样后的日志则自动上报到海外地区。 | # Builder ```java public static class Builder ``` `DiskCacheConfig` 的构建器。 ## 成员函数 | 返回 | 名称 | | --- | --- | | Builder | [setVersion](#Builder-setversion) | | Builder | [setBaseDirectoryName](#Builder-setbasedirectoryname) | | Builder | [setBaseDirectoryPath](#Builder-setbasedirectorypath) | | Builder | [setMaxCacheSize](#Builder-setmaxcachesize) | | Builder | [setMaxCacheSizeOnLowDiskSpace](#Builder-setmaxcachesizeonlowdiskspace) | | Builder | [setMaxCacheSizeOnVeryLowDiskSpace](#Builder-setmaxcachesizeonverylowdiskspace) | | Builder | [setNeedMD5](#Builder-setneedmd5) | | Builder | [setNeedEncrypt](#Builder-setneedencrypt) | | Builder | [setConfigBaseDirectoryName](#Builder-setconfigbasedirectoryname) | | Builder | [setConfigBaseDirectoryPath](#Builder-setconfigbasedirectorypath) | ## 函数说明 ### setVersion ```java public Builder setVersion(int version) ``` 设置版本号。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | version | int | 版本号 | **注意** 缓存位于此版本标识的子目录中。 ### setBaseDirectoryName ```java public Builder setBaseDirectoryName(String baseDirectoryName) ``` 设置缓存所在的目录名称。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | baseDirectoryName | String | 目录名称 | ### setBaseDirectoryPath ```java public Builder setBaseDirectoryPath(final File baseDirectoryPath) ``` 设置基础目录路径。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | baseDirectoryPath | final File | 基础目录路径 | **注意** 具有给定基本目录名称的目录（请参阅 [setBaseDirectoryName](#Builder-setbasedirectoryname)）将追加到此路径。 ### setMaxCacheSize ```java public Builder setMaxCacheSize(long maxCacheSize) ``` 设置最大缓存大小。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | maxCacheSize | long | 最大缓存大小，单位为 Byte。 | ### setMaxCacheSizeOnLowDiskSpace ```java public Builder setMaxCacheSizeOnLowDiskSpace(long maxCacheSizeOnLowDiskSpace) ``` 当设备磁盘空间不足时，设置最大缓存大小。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | maxCacheSizeOnLowDiskSpace | long | 最大缓存大小，单位为 Byte。 | **注意** 详见 DiskTrimmable 的 trimToMinimum。 ### setMaxCacheSizeOnVeryLowDiskSpace ```java public Builder setMaxCacheSizeOnVeryLowDiskSpace(long maxCacheSizeOnVeryLowDiskSpace) ``` 当设备的磁盘空间极低时，设置最大缓存大小。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | maxCacheSizeOnVeryLowDiskSpace | long | 最大缓存大小，单位为 Byte。 | **注意** 详见 DiskTrimmable 的 trimToNothing。 ### setNeedMD5 ```java public Builder setNeedMD5(boolean needMD5) ``` 设置从磁盘缓存中读取映像时比较 MD5。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | needMD5 | boolean | 是否从磁盘缓存中读取映像时比较 MD5。

`true`：是

`false`：否

| ### setNeedEncrypt ```java public Builder setNeedEncrypt(boolean needEncrypt) ``` 设置光盘缓存需要加密写入。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | needEncrypt | boolean | 光盘缓存是否需要加密写入。

`true`：是

`false`：否

| ### setConfigBaseDirectoryName ```java public Builder setConfigBaseDirectoryName(String configBaseDirectoryName) ``` 设置配置缓存所在的目录的名称。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | configBaseDirectoryName | String | 目录名称 | ### setConfigBaseDirectoryPath ```java public Builder setConfigBaseDirectoryPath(final File configBaseDirectoryPath) ``` 设置配置基础目录的路径。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | configBaseDirectoryPath | final File | 基础目录路径 | **注意** 具有给定配置基本目录名称的目录（详见 [setConfigBaseDirectoryName](#Builder-setconfigbasedirectoryname)）将追加到此路径。 # DiskCacheConfig ```java public class DiskCacheConfig ``` 磁盘缓存配置相关接口。 ## 静态函数 | 返回 | 名称 | | --- | --- | | static Builder | [newBuilder](#DiskCacheConfig-newbuilder) | ## 函数说明 ### newBuilder ```java public static Builder newBuilder(@Nullable Context context) ``` 创建一个 `DiskCacheConfig` 的构建器。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | context | @Nullable Context | 如果此值为 null，则必须显式调用 [setBaseDirectoryPath](#Builder-setbasedirectorypath) 或 setBaseDirectoryPathSupplier，否则配置将不知道在哪里物理定位缓存。 | **返回值** 一个新的 `DiskCacheConfig` 的构建器实例。 # PipelineDraweeControllerBuilder ```java public class PipelineDraweeControllerBuilder ``` ImagePipeline Drawee 控制器构建器的具体实现。 ## 成员函数 | 返回 | 名称 | | --- | --- | | PipelineDraweeControllerBuilder | [setUri](#PipelineDraweeControllerBuilder-seturi) | | SimpleDraweeControllerBuilder | [setUri](#PipelineDraweeControllerBuilder-seturi-2) | | PipelineDraweeControllerBuilder | [setUri](#PipelineDraweeControllerBuilder-seturi-3) | ## 函数说明 ### setUri ```java public PipelineDraweeControllerBuilder setUri(@Nullable Uri uri) ``` 设置加载图片 Uri。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | uri | @Nullable Uri | 图片 Uri 对象。 | **返回值** 更改过的 `PipelineDraweeControllerBuilder` 实例对象。 ### setUri ```java SimpleDraweeControllerBuilder setUri( Uri uri, String publicKey, String urlKey ) ``` 设置加载加密图片 Uri。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | uri | Uri | 图片 Uri 对象 | | publicKey | String | 您在 veImageX 控制台获取的[公钥](https://www.volcengine.com/docs/508/735219#%E7%94%B3%E8%AF%B7%E5%8A%A0%E5%AF%86%E5%AF%86%E9%92%A5)（数据加密密钥），用于解密对称密钥。 | | urlKey | String | 您在上传 SDK 用于加密文件的[对称密钥](https://www.volcengine.com/docs/508/148789)，用于解密加密数据。 | **返回值** 更改过的 `PipelineDraweeControllerBuilder` 实例对象。 ### setUri ```java public PipelineDraweeControllerBuilder setUri(@Nullable String uriString) ``` 设置加载图片 Uri 字符。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | uriString | @Nullable String | 图片 Uri 字符 | **返回值** 更改过的 `PipelineDraweeControllerBuilder` 实例对象。 **注意** 详见 AbstractDraweeControllerBuilder。 # GenericDraweeHierarchyBuilder ```java public class GenericDraweeHierarchyBuilder ``` `GenericDraweeHierarchy`的构建器。 :::tip drawable 不得由 multiple hierarchies 重复使用。每个 hierarchy 都需要有自己的 drawable 实例。由于此构建器不对输入参数进行深度拷贝，因此需要调用方负责为构建的每个层次结构传递不同的 drawable 实例。同样，hierarchies 不得由多个视图重复使用。每个视图都需要有自己的视图 hierarchy 实例。调用方负责为每个视图构建新的 hierarchy。 ::: ## 成员变量 | 类型 | 默认值 | 名称 | | --- | --- | --- | | int | 300 | [DEFAULT_FADE_DURATION](#GenericDraweeHierarchyBuilder-default_fade_duration) | ## 静态函数 | 返回 | 名称 | | --- | --- | | static void | [setDefaultFadeDuration](#GenericDraweeHierarchyBuilder-setdefaultfadeduration) | ## 成员函数 | 返回 | 名称 | | --- | --- | | GenericDraweeHierarchyBuilder | [setFadeDuration](#GenericDraweeHierarchyBuilder-setfadeduration) | | int | [getFadeDuration](#GenericDraweeHierarchyBuilder-getfadeduration) | | GenericDraweeHierarchyBuilder | [setDesiredAspectRatio](#GenericDraweeHierarchyBuilder-setdesiredaspectratio) | | float | [getDesiredAspectRatio](#GenericDraweeHierarchyBuilder-getdesiredaspectratio) | | GenericDraweeHierarchyBuilder | [setPlaceholderImage](#GenericDraweeHierarchyBuilder-setplaceholderimage) | | GenericDraweeHierarchyBuilder | [setPlaceholderImage](#GenericDraweeHierarchyBuilder-setplaceholderimage-2) | | GenericDraweeHierarchyBuilder | [setPlaceholderImageScaleType](#GenericDraweeHierarchyBuilder-setplaceholderimagescaletype) | | GenericDraweeHierarchyBuilder | [setPlaceholderImage](#GenericDraweeHierarchyBuilder-setplaceholderimage-3) | | GenericDraweeHierarchyBuilder | [setPlaceholderImage](#GenericDraweeHierarchyBuilder-setplaceholderimage-4) | | GenericDraweeHierarchyBuilder | [setRetryImage](#GenericDraweeHierarchyBuilder-setretryimage) | | GenericDraweeHierarchyBuilder | [setRetryImage](#GenericDraweeHierarchyBuilder-setretryimage-2) | | GenericDraweeHierarchyBuilder | [setRetryImageScaleType](#GenericDraweeHierarchyBuilder-setretryimagescaletype) | | GenericDraweeHierarchyBuilder | [setRetryImage](#GenericDraweeHierarchyBuilder-setretryimage-3) | | GenericDraweeHierarchyBuilder | [setRetryImage](#GenericDraweeHierarchyBuilder-setretryimage-4) | | GenericDraweeHierarchyBuilder | [setFailureImage](#GenericDraweeHierarchyBuilder-setfailureimage) | | GenericDraweeHierarchyBuilder | [setFailureImage](#GenericDraweeHierarchyBuilder-setfailureimage-2) | | GenericDraweeHierarchyBuilder | [setFailureImageScaleType](#GenericDraweeHierarchyBuilder-setfailureimagescaletype) | | GenericDraweeHierarchyBuilder | [setFailureImage](#GenericDraweeHierarchyBuilder-setfailureimage-3) | | GenericDraweeHierarchyBuilder | [setFailureImage](#GenericDraweeHierarchyBuilder-setfailureimage-4) | | GenericDraweeHierarchyBuilder | [setProgressBarImage](#GenericDraweeHierarchyBuilder-setprogressbarimage) | | GenericDraweeHierarchyBuilder | [setProgressBarImage](#GenericDraweeHierarchyBuilder-setprogressbarimage-2) | | GenericDraweeHierarchyBuilder | [setProgressBarImageScaleType](#GenericDraweeHierarchyBuilder-setprogressbarimagescaletype) | | GenericDraweeHierarchyBuilder | [setProgressBarImage](#GenericDraweeHierarchyBuilder-setprogressbarimage-3) | | GenericDraweeHierarchyBuilder | [setProgressBarImage](#GenericDraweeHierarchyBuilder-setprogressbarimage-4) | | GenericDraweeHierarchyBuilder | [setActualImageScaleType](#GenericDraweeHierarchyBuilder-setactualimagescaletype) | | GenericDraweeHierarchyBuilder | [setActualImageFocusPoint](#GenericDraweeHierarchyBuilder-setactualimagefocuspoint) | | GenericDraweeHierarchyBuilder | [setActualImageColorFilter](#GenericDraweeHierarchyBuilder-setactualimagecolorfilter) | | GenericDraweeHierarchyBuilder | [setBackground](#GenericDraweeHierarchyBuilder-setbackground) | | GenericDraweeHierarchyBuilder | [setOverlays](#GenericDraweeHierarchyBuilder-setoverlays) | | GenericDraweeHierarchyBuilder | [setOverlay](#GenericDraweeHierarchyBuilder-setoverlay) | | GenericDraweeHierarchyBuilder | [setPressedStateOverlay](#GenericDraweeHierarchyBuilder-setpressedstateoverlay) | | GenericDraweeHierarchyBuilder | [setRoundingParams](#GenericDraweeHierarchyBuilder-setroundingparams) | | GenericDraweeHierarchy | [build](#GenericDraweeHierarchyBuilder-build) | ## 变量说明 ### DEFAULT_FADE_DURATION ```java public static final int DEFAULT_FADE_DURATION = 300 ``` 淡入淡出动画的默认时长为 300ms。 ## 函数说明 ### setDefaultFadeDuration ```java public static void setDefaultFadeDuration(int fadeDuration) ``` 设置图像的淡入淡出时间。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | fadeDuration | int | 淡入淡出时间，单位为 ms。 | ### setFadeDuration ```java public GenericDraweeHierarchyBuilder setFadeDuration(int fadeDuration) ``` 设置淡入淡出持续时间。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | fadeDuration | int | 淡入淡出时间，单位为 ms，默认值为 300ms。 | ### getFadeDuration ```java public int getFadeDuration() ``` 获取淡入淡出持续时间。 **返回值** 淡入淡出时间，单位为 ms。 ### setDesiredAspectRatio ```java public GenericDraweeHierarchyBuilder setDesiredAspectRatio(float desiredAspectRatio) ``` 设置图像的宽高比。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | desiredAspectRatio | float | 宽高比 | **返回值** `GenericDraweeHierarchyBuilder`实例 **注意** hierarchy 本身无法强制执行宽高比设置。若视图支持，该配置仅做为建议。 ### getDesiredAspectRatio ```java public float getDesiredAspectRatio() ``` 获取所需的宽高比。 **返回值** 宽高比 ### setPlaceholderImage ```java public GenericDraweeHierarchyBuilder setPlaceholderImage(@Nullable Drawable placeholderDrawable) ``` 设置占位图。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | placeholderDrawable | @Nullable Drawable | 占位图 | ### setPlaceholderImage ```java public GenericDraweeHierarchyBuilder setPlaceholderImage(int resourceId) ``` 设置占位图资源 ID。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | resourceId | int | 占位图资源 ID | ### setPlaceholderImageScaleType ```java public GenericDraweeHierarchyBuilder setPlaceholderImageScaleType( @Nullable ScalingUtils.ScaleType placeholderImageScaleType) ``` 设置占位图的缩放模式。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | placeholderImageScaleType | @Nullable ScalingUtils.ScaleType | 占位图缩放模式 | ### setPlaceholderImage ```java public GenericDraweeHierarchyBuilder setPlaceholderImage( Drawable placeholderDrawable, @Nullable ScalingUtils.ScaleType placeholderImageScaleType ) ``` 设置占位图并指定缩放模式。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | placeholderDrawable | Drawable | 占位图 | | placeholderImageScaleType | @Nullable ScalingUtils.ScaleType | 占位图缩放模式 | **返回值** `GenericDraweeHierarchyBuilder`实例。 ### setPlaceholderImage ```java public GenericDraweeHierarchyBuilder setPlaceholderImage( int resourceId, @Nullable ScalingUtils.ScaleType placeholderImageScaleType ) ``` 设置占位符的资源 ID 并指定缩放模式。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | resourceId | int | 占位图资源 ID | | placeholderImageScaleType | @Nullable ScalingUtils.ScaleType | 占位图缩放模式 | **返回值** `GenericDraweeHierarchyBuilder`实例。 ### setRetryImage ```java public GenericDraweeHierarchyBuilder setRetryImage(@Nullable Drawable retryDrawable) ``` 设置重试图像。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | retryDrawable | @Nullable Drawable | 重试图片 | **返回值** `GenericDraweeHierarchyBuilder`实例。 ### setRetryImage ```java public GenericDraweeHierarchyBuilder setRetryImage(int resourceId) ``` 设置重试图像资源 ID。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | resourceId | int | 重试图像资源 ID | **返回值** `GenericDraweeHierarchyBuilder`实例。 ### setRetryImageScaleType ```java public GenericDraweeHierarchyBuilder setRetryImageScaleType( @Nullable ScalingUtils.ScaleType retryImageScaleType) ``` 设置重试图像缩放模式。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | retryImageScaleType | @Nullable ScalingUtils.ScaleType | 缩放模式 | **返回值** `GenericDraweeHierarchyBuilder`实例。 ### setRetryImage ```java public GenericDraweeHierarchyBuilder setRetryImage( Drawable retryDrawable, @Nullable ScalingUtils.ScaleType retryImageScaleType ) ``` 设置重试图像并指定缩放模式。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | retryDrawable | Drawable | 重试图片 | | retryImageScaleType | @Nullable ScalingUtils.ScaleType | 缩放模式 | **返回值** `GenericDraweeHierarchyBuilder`实例。 ### setRetryImage ```java public GenericDraweeHierarchyBuilder setRetryImage( int resourceId, @Nullable ScalingUtils.ScaleType retryImageScaleType ) ``` 设置重试图片资源 ID 并指定缩放模式。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | resourceId | int | 重试图片资源 ID | | retryImageScaleType | @Nullable ScalingUtils.ScaleType | 缩放模式 | **返回值** `GenericDraweeHierarchyBuilder`实例。 ### setFailureImage ```java public GenericDraweeHierarchyBuilder setFailureImage(@Nullable Drawable failureDrawable) ``` 设置失败时加载图片。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | failureDrawable | @Nullable Drawable | 失败图片 | **返回值** `GenericDraweeHierarchyBuilder`实例。 ### setFailureImage ```java public GenericDraweeHierarchyBuilder setFailureImage(int resourceId) ``` 设置失败图片资源 ID。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | resourceId | int | 失败图片资源 ID | **返回值** `GenericDraweeHierarchyBuilder`实例。 ### setFailureImageScaleType ```java public GenericDraweeHierarchyBuilder setFailureImageScaleType( @Nullable ScalingUtils.ScaleType failureImageScaleType) ``` 设置失败时图片的缩放模式。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | failureImageScaleType | @Nullable ScalingUtils.ScaleType | 缩放模式 | **返回值** `GenericDraweeHierarchyBuilder`实例。 ### setFailureImage ```java public GenericDraweeHierarchyBuilder setFailureImage( Drawable failureDrawable, @Nullable ScalingUtils.ScaleType failureImageScaleType ) ``` 设置在加载图像失败时显示的失败图像和其缩放类型。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | failureDrawable | Drawable | 失败图像 | | failureImageScaleType | @Nullable ScalingUtils.ScaleType | 失败时的缩放模式 | **返回值** `GenericDraweeHierarchyBuilder`实例。 ### setFailureImage ```java public GenericDraweeHierarchyBuilder setFailureImage( int resourceId, @Nullable ScalingUtils.ScaleType failureImageScaleType ) ``` 设置在加载图像失败时显示的失败图像资源 ID 和其缩放类型。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | resourceId | int | 失败时的图像资源 ID | | failureImageScaleType | @Nullable ScalingUtils.ScaleType | 失败时的图像缩放模式 | **返回值** `GenericDraweeHierarchyBuilder`实例。 ### setProgressBarImage ```java public GenericDraweeHierarchyBuilder setProgressBarImage(@Nullable Drawable progressBarDrawable) ``` 自定义图片加载进度条图像。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | progressBarDrawable | @Nullable Drawable | 加载进度条图像 | **返回值** `GenericDraweeHierarchyBuilder`实例。 ### setProgressBarImage ```java public GenericDraweeHierarchyBuilder setProgressBarImage(int resourceId) ``` 自定义图片加载进度条资源 ID。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | resourceId | int | 加载进度条资源 ID | **返回值** `GenericDraweeHierarchyBuilder`实例。 ### setProgressBarImageScaleType ```java public GenericDraweeHierarchyBuilder setProgressBarImageScaleType( @Nullable ScalingUtils.ScaleType progressBarImageScaleType) ``` 自定义图片加载进度条的缩放模式。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | progressBarImageScaleType | @Nullable ScalingUtils.ScaleType | 进度条缩放模式 | **返回值** `GenericDraweeHierarchyBuilder`实例。 ### setProgressBarImage ```java public GenericDraweeHierarchyBuilder setProgressBarImage( Drawable progressBarDrawable, @Nullable ScalingUtils.ScaleType progressBarImageScaleType ) ``` 同时自定义图片加载时进度条图像和缩放模式。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | progressBarDrawable | Drawable | 进度条图像 | | progressBarImageScaleType | @Nullable ScalingUtils.ScaleType | 进度条缩放模式 | **返回值** `GenericDraweeHierarchyBuilder`实例。 ### setProgressBarImage ```java public GenericDraweeHierarchyBuilder setProgressBarImage( int resourceId, @Nullable ScalingUtils.ScaleType progressBarImageScaleType ) ``` 同时自定义图片加载时进度条资源 ID 和缩放模式。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | resourceId | int | 进度条资源 ID | | progressBarImageScaleType | @Nullable ScalingUtils.ScaleType | 缩放模式 | **返回值** `GenericDraweeHierarchyBuilder`实例。 ### setActualImageScaleType ```java public GenericDraweeHierarchyBuilder setActualImageScaleType( @Nullable ScalingUtils.ScaleType actualImageScaleType) ``` 设置真实图片的缩放模式。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | actualImageScaleType | @Nullable ScalingUtils.ScaleType | 缩放模式 | **返回值** `GenericDraweeHierarchyBuilder`实例。 ### setActualImageFocusPoint ```java public GenericDraweeHierarchyBuilder setActualImageFocusPoint(@Nullable PointF focusPoint) ``` 设置真实图像的焦点。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | focusPoint | @Nullable PointF | 真实图像的焦点 | **返回值** `GenericDraweeHierarchyBuilder`实例。 ### setActualImageColorFilter ```java public GenericDraweeHierarchyBuilder setActualImageColorFilter( @Nullable ColorFilter colorFilter) ``` 设置真实图像的滤色器。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | colorFilter | @Nullable ColorFilter | 图像滤色器 | **返回值** `GenericDraweeHierarchyBuilder`实例。 ### setBackground ```java public GenericDraweeHierarchyBuilder setBackground(@Nullable Drawable background) ``` 设置图像背景。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | background | @Nullable Drawable | 图像的背景图 | **返回值** `GenericDraweeHierarchyBuilder`实例。 ### setOverlays ```java public GenericDraweeHierarchyBuilder setOverlays(@Nullable List overlays) ``` 设置叠加层。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | overlays | @Nullable List\ | 图像的叠加层 | **返回值** `GenericDraweeHierarchyBuilder`实例。 **注意** 叠加层按列表顺序绘制在背景和层次结构的其余部分之后。最后一个叠加层将绘制在顶部。 ### setOverlay ```java public GenericDraweeHierarchyBuilder setOverlay(@Nullable Drawable overlay) ``` 设置单一的叠加层。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | overlay | @Nullable Drawable | 图像的叠加层 | **返回值** `GenericDraweeHierarchyBuilder`实例。 **注意** 叠加层按列表顺序绘制在背景和层次结构的其余部分之后。最后一个叠加层将绘制在顶部。 ### setPressedStateOverlay ```java public GenericDraweeHierarchyBuilder setPressedStateOverlay(@Nullable Drawable drawable) ``` 设置按压状态下的叠加层图像。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | drawable | @Nullable Drawable | 按压状态下的叠加层 | **返回值** `GenericDraweeHierarchyBuilder`实例。 ### setRoundingParams ```java public GenericDraweeHierarchyBuilder setRoundingParams(@Nullable RoundingParams roundingParams) ``` 设置图像的圆角处理参数。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | roundingParams | @Nullable RoundingParams | 圆角处理参数，详见 [RoundingParams](#RoundingParams)。 | **返回值** `GenericDraweeHierarchyBuilder`实例。 ### build ```java public GenericDraweeHierarchy build() ``` 构建器的构建方法，返回新创建的`GenericDraweeHierarchy`实例。 **返回值** `GenericDraweeHierarchy`实例。 # FormatChecker ```java public interface FormatChecker ``` 图片的格式检查器。 ## 成员函数 | 返回 | 名称 | | --- | --- | | int | [getHeaderSize](#FormatChecker-getheadersize) | | ImageFormat | [determineFormat](#FormatChecker-determineformat) | ## 函数说明 ### getHeaderSize ```java int getHeaderSize() ``` 获取格式检查器所需的标头字节数。 **返回值** 格式检查器所需的标头字节数 ### determineFormat ```java ImageFormat determineFormat( @Nonnull byte[] headerBytes, int headerSize ) ``` 确定给定图像数据的格式。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | headerBytes | @Nonnull byte[] | 要检查的标头字节 | | headerSize | int | 标头的大小，单位为字节。 | **返回值** 当检查器能够确定格式，则返回 [ImageFormat](1262421#ImageFormat)，否则返回 null。 # Heif ```java public class Heif ``` HEIF 解码相关接口。 ## 静态函数 | 返回 | 名称 | | --- | --- | | static native HeifData | [toRgba](#Heif-torgba) | | static native HeifData | [toRgb565](#Heif-torgb565) | | static native int[] | [parseSimpleMeta](#Heif-parsesimplemeta) | | static Bitmap | [getBitmap](#Heif-getbitmap) | ## 函数说明 ### toRgba ```java public static native HeifData toRgba( byte[] data, int size, boolean wpp, int inSample, int x, int y, int height, int width ) ``` 将原始 HEIF 图片解码为 rgba 数据。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | data | byte[] | 图片原始数据。 | | size | int | `data` 的数组长度。 | | wpp | boolean | 暂未使用，请传入 `false`。 | | inSample | int | 图片降采样倍数，即指定图像尺寸等比缩小的比例。取值需大于等于 1，取值为 2 时，表示生成图的宽高将缩小为原图尺寸的一半。 | | x | int | 解码起始的横坐标，取值请勿超过图片边界。 | | y | int | 解码起始的纵坐标，取值请勿超过图片边界。 | | height | int | 期望解码的高度，与 y 坐标搭配使用，单位为 px。取值请勿超过图片边界。 | | width | int | 期望解码的宽度，与 x 坐标结合使用，单位为 px。取值请勿超过图片边界。 | **返回值** 对解码后的 byte[] 数据的封装，要转为 Bitmap，请调用 [HeifData.newBitmap()](https://www.volcengine.com/docs/508/1262421#newbitmap) 接口 ### toRgb565 ```java public static native HeifData toRgb565( byte[] data, int size, boolean wpp, int inSample, int x, int y, int height, int width ) ``` 将原始 HEIF 图片解码为 rgb565 数据。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | data | byte[] | 图片原始数据。 | | size | int | `data` 的数组长度。 | | wpp | boolean | 暂未使用，请传入 `false`。 | | inSample | int | 图片降采样倍数，即指定图像尺寸等比缩小的比例。取值需大于等于 1，取值为 2 时，表示生成图的宽高将缩小为原图尺寸的一半。 | | x | int | 解码起始的横坐标，请勿超过图片边界 | | y | int | 解码起始的纵坐标，请勿超过图片边界 | | height | int | 期望解码的高度，与y坐标结合使用，单位为 px。请勿超过图片边界。 | | width | int | 期望解码的宽度，与x坐标结合使用，单位为 px。请勿超过图片边界。 | **返回值** 对解码后的 byte[] 数据的封装，要转为 Bitmap，请调用 [HeifData.newBitmap()](https://www.volcengine.com/docs/508/1262421#newbitmap) 接口。 ### parseSimpleMeta ```java public static native int[] parseSimpleMeta( byte[] data, int size ) ``` 解析并获取 HEIF 图片部分元数据信息。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | data | byte[] | 图片原始数据 | | size | int | `data` 的数组长度 | **返回值** meta 数据，数组元素 10 个，值依次表示：宽，高，图片角度(顺指针角度，取值0,90,180,270)，是否为动图(0：静图，1：动图)，动图时长，是否含有缩略图（0：没有，1：有），缩略图下标，缩略图大小，是否含有透明通道（0：没有，1：有），位深。 ### getBitmap ```java public static Bitmap getBitmap( byte[] data, boolean isRgba, int inSample ) ``` 解析并获取 HEIF 图的 Bitmap 对象。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | data | byte[] | 图片原始数据。 | | isRgba | boolean | 图片是否包含透明通道。

`true`：有透明通道

`false`：无透明通道

| | inSample | int | 图片降采样倍数，即指定图像尺寸等比缩小的比例。取值需大于等于 1，取值为 2 时，表示生成图的宽高将缩小为原图尺寸的一半。 | **返回值** Bitmap对象 # ImageDecoderConfig ```java public class ImageDecoderConfig ``` ImageDecoder 配置类。 ## 静态函数 | 返回 | 名称 | | --- | --- | | static Builder | [newBuilder](#ImageDecoderConfig-newbuilder) | ## 函数说明 ### newBuilder ```java public static Builder newBuilder() ``` 创建一个 `ImageDecoderConfig.Builder` 实例。 **返回值** 一个 `ImageDecoderConfig.Builder` 的新实例。 # ImageRequest ```java public class ImageRequest ``` `Pipeline` 需要知道的关于请求图片的一切信息都会封装到`ImageRequest`对象之中。 ## 静态函数 | 返回 | 名称 | | --- | --- | | static ImageRequest | [fromFile](#ImageRequest-fromfile) | | static ImageRequest | [fromUri](#ImageRequest-fromuri) | | static ImageRequest | [fromUri](#ImageRequest-fromuri-2) | ## 函数说明 ### fromFile ```java public static ImageRequest fromFile(@Nullable File file) ``` 加载本地图片。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | file | @Nullable File | 本地图片文件 | **返回值** `ImageRequest`实例对象。 ### fromUri ```java public static ImageRequest fromUri(@Nullable Uri uri) ``` 加载 Uri 图片。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | uri | @Nullable Uri | Uri 图片对象 | **返回值** `ImageRequest`实例对象。 ### fromUri ```java public static ImageRequest fromUri(@Nullable String uriString) ``` 加载 Uri 字符串图片。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | uriString | @Nullable String | 图片 Uri 字符串 | **返回值** `ImageRequest`实例对象。 # Builder ```java public static class Builder ``` `ImagePipelineConfig`的构建器。 ## 成员函数 | 返回 | 名称 | | --- | --- | | Builder | [setWasImmediate](#Builder-setwasimmediate) | | Builder | [setBitmapsConfig](#Builder-setbitmapsconfig) | | Builder | [setDownsampleEnabled](#Builder-setdownsampleenabled) | | Builder | [setDiskCacheEnabled](#Builder-setdiskcacheenabled) | | Builder | [setImageDecoder](#Builder-setimagedecoder) | | Builder | [setRequestListeners](#Builder-setrequestlisteners) | ## 函数说明 ### setWasImmediate ```java public Builder setWasImmediate(boolean wasImmediate) ``` 设置立即加载图像。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | wasImmediate | boolean | 是否立即加载图像。

`true`: 图像将立即显示（无淡入淡出效果）。

`false`: 经过淡入淡出效果后再显示图片。

| **返回值** `ImagePipelineConfig.Builder`实例 ### setBitmapsConfig ```java public Builder setBitmapsConfig(Bitmap.Config config) ``` 设置加载的图像的 Bitmap 配置。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | config | Bitmap.Config | Bitmap 配置。 | **返回值** `ImagePipelineConfig.Builder`实例 ### setDownsampleEnabled ```java public Builder setDownsampleEnabled(boolean downsampleEnabled) ``` 设置是否降采样处理。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | downsampleEnabled | boolean | 是否降采样。

`true`: 设置降采样。

`false`: （默认）不设置降采样。

| **返回值** `ImagePipelineConfig.Builder`实例 ### setDiskCacheEnabled ```java public Builder setDiskCacheEnabled(boolean diskCacheEnabled) ``` 设置磁盘缓存是否可用。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | diskCacheEnabled | boolean | 磁盘缓存是否可用。

`true`: （默认）设置磁盘缓存可用。

`false`: 磁盘缓存不可用。

| **返回值** `ImagePipelineConfig.Builder`实例 ### setImageDecoder ```java public Builder setImageDecoder(ImageDecoder imageDecoder) ``` 设置图片唯一解码器。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | imageDecoder | ImageDecoder | 图片解码器 | **返回值** `ImagePipelineConfig.Builder`实例。 **注意** 如果使用该方法设置解码器，那么 [ImageDecoderConfig](#ImageDecoderConfig) 结合`ImagePipelineConfig.setImageDecoderConfig`设置的解码器将不再生效。 ### setRequestListeners ```java public Builder setRequestListeners(Set requestListeners) ``` 设置图片请求监听器列表。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | requestListeners | Set\ | 图片请求监听器列表，详见 [RequestListener](https://www.volcengine.com/docs/508/1262420#imagetracelistener)。 | **返回值** `ImagePipelineConfig.Builder`实例。