# H5web ## 一、使用场景 1）拥有自己的<font color='red'>H5网站</font>或<font color='red'>混合开发的App</font>，需要将小鹅通的H5店铺与自己的H5系统相结合。 2）使用混合开发技术的App，例如Uni-app、Fultter、React-Native等开发的App需要嵌入SDK的。 <font color='red'>**iOS App中课程支付必须接入iOS代币支付方案，因苹果对于虚拟产品有收取“苹果税”的规则，如不遵守会有下架风险**</font> [详细了解请点击](recall_scene/lnline_sdk/business/pay.md) <br/> **可实现：** 1. 登录了自有H5系统后，<font color='red'>不用再登录小鹅通的H5店铺</font> ，可直接打开直播间观看直播或课程。 2. 用户拿到小鹅通课程链接，在手机浏览器（或微信）访问，会先跳转至您的H5系统进行登录后，您可以判断其是否有权益看该课程后，再进入小鹅通课程。 3. 单点登录，登录功能交予您处理，走完您的自有登录流程，再打通小鹅通登录。 4. <font style='background:yellow'>混合开发技术的App或不想引入SDK包的App，能够嵌入SDK。</font>`` ## 混合开发App（非原生APP)接入 因目前AppSDK还没有提供混合开发版本的SDK，所以目前只能选择WebSDK的方式去嵌入。 注释： Websdk，本身是不引入任何外部插件的，完全由Web后端来注入登录态信息（cookie中的token）。 Websdk的原理，登录动作交予给您处理。直接由小鹅通的Web网关来判断是否有已登录小鹅通，如果没登录，会直接重定向你方提供的H5“登录页”（即时序图中第3步）。 <br>  <br> ## 实例效果： 1. 举例两种模式 App是原生开发的，但是不愿意引入原生SDK，腾讯音乐TME酷狗接入效果如下。  <br> 超预期App例子，混合开发的App，使用websdk接入效果如下  <br> 2. 举例接下来几种情况，可灵活运用 >情况一：（App未登录）App容器可以判断到当访问这个登录页的地址，判断用户是否已登录App。 第一步：如果未登录App，拉起App登录页，做完App登录后随机调用小鹅通【[注册用户api](https://api-doc.xiaoe-tech.com/api_list/user/register.html)】注册获得了小鹅通user\_id并做好存储关联。 第二步：然后拿着小鹅通user\_id调用login.url接口获取登录链接，登录链接交给App客户端，去跳转，跳转后即是小鹅通首页，并且已登录状态。 注：当执行了一次如上操作后，24小时内，在app中访问小鹅通任何链接，都有登录态，因为浏览器cookie中已经存在了有效登录态。 <br> 情况二：（App已登录）因小鹅通Web的登录态有效期只有24小时，App的登录态一般都是几天，所以存在App已登录，小鹅通Web失效了。 当出现这种情况，App无需重新拉取自己的登录页，App自己判断清楚，1、直接重新调用一个获取新的login.url接口即可，2、直接拿着user\_id请求新的登录链接，客户端重新跳转即可。 3. 接口清单 [注册用户](https://api-doc.xiaoe-tech.com/api_list/user/register.html)  4. 常见问题： Q:<font color='red'>sdk_app_id</font>在哪里取？ A：应用-经营去到-SDK服务-SDK管理-基本信息  <br> Q：<font color='red'>sdk_user_id</font>是什么 A：可以理解为你方系统的userid（app_user_id）或任何唯一的值，用作小鹅通与你方账号关联的依据。 [获取登录链接](https://api-doc.xiaoe-tech.com/recall_scene/lnline_sdk/h5_sdk.html)  <br> <font style='background:yellow'>Q：redirect_uri是干嘛的？</font> A：目标回调地址，非必传，如果不传，登录链接跳转后默认回到首页。 App场景中经常是用户直接点击直播间进入小鹅通Web，当无登录态时，会调转到你方配置的登录页，举个例子跳转过去会是这样的【https://app.wuhangshengcai.com/xiaoe/login.html?redirect_uri=https://appxxxxx.h5.xiaoeknow.com/v2/alive/id_xxxxxxxx】 <font color='red'>**可以看出，客户想进入的直播间地址会通过get参数带给你方登录页，供你方调用login.url时传入，这种情况获得的登录链接，跳转后会直接进入直播间，不会去首页。**</font> <br> Q：登录页在哪里设置？ A：应用-经营去到-SDK服务-SDK管理-平台信息-WebSDK接入