截取当前屏幕
<h1>截取当前屏幕</h1>
<h2>功能描述</h2>
<p>截取当前屏幕并保存为 PNG 文件。</p>
<h2>输入参数</h2>
<ul>
<li><strong>截图路径</strong>:字符串(可选,默认为环境相关路径):
- PC 环境:<code>&quot;D:/&lt;时间戳&gt;.png&quot;</code>(如 <code>&quot;D:/20250928123000.png&quot;</code>)。
- 安卓环境:<code>&quot;/storage/emulated/0/Pictures/&lt;时间戳&gt;.png&quot;</code>(如 <code>&quot;/storage/emulated/0/Pictures/20250928123000.png&quot;</code>)。</li>
</ul>
<h2>输出结果</h2>
<ul>
<li><strong>执行结果</strong>:
- <code>true</code>(成功时)。
- <code>false</code>(失败时)。</li>
</ul>
<h2>日志记录</h2>
<ul>
<li>输入参数:
- <code>截图路径: &quot;D:/截图.png&quot;</code> 或 <code>&quot;/storage/emulated/0/Pictures/截图.png&quot;</code></li>
<li>输出结果:
- <code>执行结果: true</code> 或 <code>false</code></li>
<li>日志信息:
- <code>截图已保存至: D:/截图.png</code>(成功时)。
- <code>截图保存失败: 错误信息</code>(失败时)。
- <code>截图路径未包含 .png 后缀,请确保路径包含文件名和后缀(示例:D:/截图.png)</code>(路径无效时)。</li>
</ul>
<h2>示例</h2>
<h3>场景 1:使用默认路径(PC 环境)</h3>
<ul>
<li><strong>输入参数</strong>:
- 截图路径:未提供(使用默认值)。</li>
<li><strong>输出结果</strong>:
- <code>执行结果: true</code></li>
<li><strong>日志输出</strong>:
- <code>截图已保存至: D:/20250928123000.png</code></li>
</ul>
<h3>场景 2:使用默认路径(安卓环境)</h3>
<ul>
<li><strong>输入参数</strong>:
- 截图路径:未提供(使用默认值)。</li>
<li><strong>输出结果</strong>:
- <code>执行结果: true</code></li>
<li><strong>日志输出</strong>:
- <code>截图已保存至: /storage/emulated/0/Pictures/20250928123000.png</code></li>
</ul>
<h3>场景 3:指定路径(PC 环境)</h3>
<ul>
<li><strong>输入参数</strong>:
- 截图路径:<code>&quot;D:/截图.png&quot;</code></li>
<li><strong>输出结果</strong>:
- <code>执行结果: true</code></li>
<li><strong>日志输出</strong>:
- <code>截图已保存至: D:/截图.png</code></li>
</ul>
<h3>场景 4:路径无效(缺少 .png 后缀)</h3>
<ul>
<li><strong>输入参数</strong>:
- 截图路径:<code>&quot;D:/截图&quot;</code></li>
<li><strong>输出结果</strong>:
- <code>执行结果: false</code></li>
<li><strong>日志输出</strong>:
- <code>截图路径未包含 .png 后缀,请确保路径包含文件名和后缀(示例:D:/截图.png)</code></li>
</ul>