截取当前屏幕
<h1>截取当前屏幕</h1>
<h3>功能描述</h3>
<p>截取当前屏幕并保存到指定路径。如果用户未提供保存路径，将自动生成一个时间戳命名的文件路径；如果用户提供的路径不以 <code>.png</code> 结尾，会自动补齐。</p>
<h3>输入参数</h3>
<ul>
<li><strong>保存路径</strong>（可选）
- 描述：截图保存的目标路径。如果未填写，将在 <code>/storage/emulated/0/Pictures/</code> 目录下生成时间戳命名的文件（如 <code>截屏_20250721123045.png</code>）。如果填写了路径但未以 <code>.png</code> 结尾，会自动补齐。
- 示例：<code>/storage/emulated/0/Pictures/screenshot.png</code></li>
</ul>
<h3>输出结果</h3>
<ul>
<li><strong>保存结果</strong>
- 描述：最终保存的文件路径。如果保存成功（<code>auto.capture</code> 返回 <code>true</code> 或 <code>null</code>），返回文件路径；否则返回异常信息。
- 示例：<code>/storage/emulated/0/Pictures/截屏_20250721123045.png</code></li>
</ul>
<h3>日志输出</h3>
<pre><code>[截取当前屏幕] 最终保存路径：/storage/emulated/0/Pictures/截屏_20250721123045.png
[截取当前屏幕] 截图已保存到 /storage/emulated/0/Pictures/截屏_20250721123045.png
[截取当前屏幕] 出错: [错误信息]</code></pre>
<h3>典型场景</h3>
<ol>
<li>
<p><strong>自动生成路径</strong>
- 输入：无
- 行为：自动生成时间戳命名的文件路径并保存截图</p>
</li>
<li><strong>自定义路径</strong>
- 输入：<code>保存路径=/storage/emulated/0/Pictures/screenshot</code>
- 行为：自动补全 <code>.png</code> 后缀并保存截图</li>
</ol>
<h3>注意事项</h3>
<ol>
<li>如果未提供保存路径，将自动生成一个时间戳命名的文件路径</li>
<li>如果提供的路径不以 <code>.png</code> 结尾，会自动补齐</li>
</ol>