From 4b0d994e07bdc0b782679d3f7b06fb0141db1150 Mon Sep 17 00:00:00 2001
From: lqyan <lqyan@jhinno.com>
Date: Thu, 16 May 2024 11:27:19 +0800
Subject: [PATCH] =?UTF-8?q?doc(=E5=90=AF=E5=8A=A8=E4=BC=9A=E8=AF=9D)=20?=
 =?UTF-8?q?=E6=B7=BB=E5=8A=A0=E5=90=AF=E5=8A=A8=E4=BC=9A=E8=AF=9D=E6=8E=A5?=
 =?UTF-8?q?=E5=8F=A3=E6=B3=A8=E9=87=8A?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

添加我的会话启动应用对jhappUrl使用的说明
---
 .../openapi/api/app/JHAppApiExecution.java    | 25 +++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/src/main/java/com/jhinno/sdk/openapi/api/app/JHAppApiExecution.java b/src/main/java/com/jhinno/sdk/openapi/api/app/JHAppApiExecution.java
index dcc9335..202239d 100644
--- a/src/main/java/com/jhinno/sdk/openapi/api/app/JHAppApiExecution.java
+++ b/src/main/java/com/jhinno/sdk/openapi/api/app/JHAppApiExecution.java
@@ -33,6 +33,31 @@ public class JHAppApiExecution extends JHApiExecution {
 
     /**
      * 启动一个会话
+     * <p>
+     * 改方法返回一个重要的参数{@link AppStartedInfo#getJhappUrl()}（拉起景行客户端协议的URL）。
+     * <p>
+     * 测试：将该URL复制粘贴到浏览器的地址栏进行访问即可启动会话。
+     *
+     * <p>
+     * 开发阶段，主要有一下几种方式：
+     * <ul>
+     *     <li>使用js的 `window.open({@link AppStartedInfo#getJhappUrl()})`</li>
+     *     <li>使用HTML的a标签的href</li>
+     *     <li>使用HTML的iframe标签的src</li>
+     * </ul>
+     * 以下是使用的伪代码：
+     * <pre class="code">
+     *  // 使用a标签实例代码
+     *  var a = document.createElement("a");
+     *  a.href = "{@link AppStartedInfo#getJhappUrl()}";
+     *  a.click();
+     * </pre>
+     * <pre class="code">
+     *  // 使用iframe标签实例代码
+     *  var iframe = document.createElement("iframe");
+     *  iframe.style.display = "none";
+     *  iframe.src = "{@link AppStartedInfo#getJhappUrl()}";
+     * </pre>
      *
      * @param username        用户名
      * @param appId           应用拆