保存当前截图
<h1>保存当前截图</h1>
<h2>功能描述</h2>
<p>本功能用于保存当前屏幕的截图到指定路径，支持自定义图片格式、清晰度和保存区域。</p>
<h2>输入参数</h2>
<ol>
<li>
<p><strong>保存路径</strong>（必填）：
- 描述：截图保存的目标路径，支持绝对路径或相对路径。
- 示例：<code>/storage/emulated/0/Pictures/screenshot.png</code>
- 默认值：<code>&quot;&quot;</code>（无默认值）</p>
</li>
<li>
<p><strong>图片格式</strong>（可选）：
- 描述：截图保存的格式，支持 <code>png</code>、<code>jpg</code> 或 <code>jpeg</code>。
- 示例：<code>png</code>
- 默认值：<code>png</code></p>
</li>
<li>
<p><strong>图片清晰度</strong>（可选）：
- 描述：截图的清晰度设置，取值范围为 <code>0-100</code>，数值越高清晰度越高。若未填写或无效，默认值为 <code>80</code>。
- 示例：<code>80</code>
- 默认值：<code>80</code></p>
</li>
<li><strong>保存区域</strong>（可选）：
- 描述：指定截图的区域范围，格式为 <code>x,y,w,h</code>。若格式不正确，将返回错误。
- 示例：<code>100,200,300,400</code>
- 默认值：<code>&quot;&quot;</code>（全屏截图）</li>
</ol>
<h2>输出结果</h2>
<ul>
<li><strong>文件路径</strong>：截图保存的完整路径。</li>
<li><strong>状态</strong>：保存成功或失败的状态信息。</li>
</ul>
<h2>不同场景下的输出</h2>
<ul>
<li>
<p><strong>场景 1：成功保存截图</strong>
- 场景描述：保存截图到指定路径。
- 输入参数：
- 保存路径：<code>/storage/emulated/0/Pictures/screenshot.png</code>
- 图片格式：<code>png</code>
- 图片清晰度：<code>&quot;&quot;</code>
- 保存区域：<code>&quot;&quot;</code>
- 输出结果：
- 文件路径：<code>/storage/emulated/0/Pictures/screenshot.png</code>
- 状态：<code>保存成功</code>
- 日志输出：
<code> ✔ 截图已保存到：/storage/emulated/0/Pictures/screenshot.png </code></p>
</li>
<li>
<p><strong>场景 2：图片格式不支持</strong>
- 场景描述：图片格式设置为不支持的类型。
- 输入参数：
- 保存路径：<code>/storage/emulated/0/Pictures/screenshot.bmp</code>
- 图片格式：<code>bmp</code>
- 图片清晰度：<code>&quot;&quot;</code>
- 保存区域：<code>&quot;&quot;</code>
- 输出结果：
- 文件路径：<code>&quot;&quot;</code>
- 状态：<code>图片格式不支持</code>
- 日志输出：
<code> ✘ 图片格式不支持，应为 &quot;png&quot; 或 &quot;jpg/jpeg&quot; </code></p>
</li>
<li>
<p><strong>场景 2：路径为空</strong>
- 场景描述：保存路径为空。
- 输入参数：
- 保存路径：<code>&quot;&quot;</code>
- 图片格式：<code>png</code>
- 图片清晰度：<code>&quot;&quot;</code>
- 保存区域：<code>&quot;&quot;</code>
- 输出结果：
- 文件路径：<code>&quot;&quot;</code>
- 状态：<code>路径为空</code>
- 日志输出：
<code> ✘ 路径为空，未保存截图 </code></p>
</li>
<li><strong>场景 3：自定义区域截图</strong>
- 场景描述：保存指定区域的截图。
- 输入参数：
- 保存路径：<code>/storage/emulated/0/Pictures/custom_screenshot.png</code>
- 图片格式：<code>jpg</code>
- 图片清晰度：<code>90</code>
- 保存区域：<code>100,200,300,400</code>
- 输出结果：
- 文件路径：<code>/storage/emulated/0/Pictures/custom_screenshot.jpg</code>
- 状态：<code>保存成功</code>
- 日志输出：
<code> ✔ 截图已保存到：/storage/emulated/0/Pictures/custom_screenshot.jpg </code></li>
</ul>