Android 接入场景

临境直播观看 SDK 的接入可以通过两种场景；
一、原生场景：直接从 App 原生进入直播观看；
二、H5 嵌入场景：从嵌套在 webview 的 H5 中，进入直播观看；

原生场景

原生场景接入方式

  • 首先接入临境直播观看 SDK，并配置相应环境，具体请参见 Android 接入说明文档。
  • 直接在需要跳转的 Activity 里面添加如下代码：
  1.         //设置跳转到临境直播时对应的参数
  2.         LivePullIntentDataOptions options = new LivePullIntentDataOptions();
  3.         options.setLiveRoomCode("");//设置直播室roomCode
  4.         options.setLivePlayPwd("");//设置直播观看密码
  5.         options.setUserId("");//设置用户userId
  6.         options.setUserAvatar("");//设置用户头像url
  7.         options.setUserName("");//设置用户名
  8.         options.setUserLoginName("");//可选: 设置用户登录名
  9.         options.setUserPoint(0);//设置用户积分
  11.         //跳转到相应临境直播播放页面,context为Activity的实例
  12.         LivePullManager.intentToLjLive(context, options);

H5嵌入场景

H5嵌入场景接入方式

  • 首先接入临境直播观看 SDK，并配置相应环境，具体请参见 Android 接入说明文档。
  • 在app的webview中添加云学堂直播协议代理回调；
  1. package com.yxt.demo.liveyxtsdk;
  3. import android.net.Uri;
  4. import android.os.Build;
  5. import android.os.Bundle;
  6. import android.support.v7.app.AppCompatActivity;
  7. import android.text.TextUtils;
  8. import android.util.Log;
  9. import android.webkit.CookieManager;
  10. import android.webkit.GeolocationPermissions;
  11. import android.webkit.JsPromptResult;
  12. import android.webkit.WebChromeClient;
  13. import android.webkit.WebSettings;
  14. import android.webkit.WebView;
  15. import android.webkit.WebViewClient;
  16. import android.widget.Toast;
  17. import com.yxt.sdk.live.pull.LivePullIntentDataOptions;
  18. import com.yxt.sdk.live.pull.LivePullManager;
  19. import org.json.JSONObject;
  20. import java.util.Objects;
  22. public class MainWebViewActivity extends AppCompatActivity {
  23.     protected WebView yxt_webview;
  25.     @Override
  26.     protected void onCreate(Bundle savedInstanceState) {
  27.         super.onCreate(savedInstanceState);
  28.         setContentView(R.layout.activity_main_web_test);
  29.         yxt_webview = findViewById(R.id.yxt_webview);
  31. //webview基本属性设置
  32.         yxt_webview.getSettings().setJavaScriptEnabled(true);
  33.         yxt_webview.getSettings().setDefaultTextEncodingName("utf-8");
  34.         yxt_webview.getSettings().setGeolocationEnabled(true);
  35.         yxt_webview.getSettings().setLoadWithOverviewMode(true);//设置webView自适应屏幕大小
  36.         yxt_webview.getSettings().setSupportMultipleWindows(true);
  37.         yxt_webview.getSettings().setAppCacheEnabled(true);//设置H5的缓存打开，默认关闭
  38.         yxt_webview.getSettings().setDomStorageEnabled(true);
  39.         yxt_webview.getSettings().setLoadsImagesAutomatically(true);
  40.         yxt_webview.getSettings().setAllowFileAccess(true);
  41.         yxt_webview.getSettings().setAllowFileAccessFromFileURLs(true);
  43.         yxt_webview.getSettings().setPluginState(WebSettings.PluginState.ON);// 可以使用插件
  44.         yxt_webview.getSettings().setSupportMultipleWindows(true);
  45.         if (android.os.Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
  46.             CookieManager.getInstance().setAcceptThirdPartyCookies(yxt_webview, true);
  47.         }
  48.       //添加云学堂直播的 user agent
  49.       yxt_webview.getSettings().setUserAgentString(yxt_webview.getSettings().getUserAgentString() + " XuanLiveThirdPlatform/0");
  51.         yxt_webview.setWebChromeClient(new WebChromeClient() {
  52.             @Override
  53.             public void onGeolocationPermissionsShowPrompt(String origin, GeolocationPermissions.Callback callback) {
  54.                 callback.invoke(origin, true, false);
  55.                 super.onGeolocationPermissionsShowPrompt(origin, callback);
  56.             }
  57.             @Override
  58.             public boolean onJsPrompt(WebView view, String url, String message, String defaultValue, JsPromptResult result) {
  59.                 url = message;
  60.                 Log.e("TAG", "onJsPrompt  url: " + url);
  61.                 return process(view, url, result);
  62.             }
  63.         });
  64.         yxt_webview.setWebViewClient(new WebViewClient() {
  65.             @Override
  66.             public boolean shouldOverrideUrlLoading(WebView view, String url) {
  67.                 view.loadUrl(url);
  68.                 return true;
  69.             }
  70.         });
  71.     }
  73.     /**
  74.      * YXT协议处理
  75.      *
  76.      * @param webView
  77.      * @param url
  78.      * @param result
  79.      * @return
  80.      */
  81.     public boolean process(WebView webView, String url, JsPromptResult result) {
  82.         if (!url.startsWith("http")) {
  83.             if (result != null) {
  84.                 result.confirm();
  85.                 result.cancel();
  86.             }
  87.             if (url.startsWith("yxtthirdapp://")) {
  88.                 try {
  89.                     Uri uri = Uri.parse(url);
  90.                     String host = Objects.requireNonNull(uri.getHost()).toLowerCase();
  91.                     // 域名 空判断
  92.                     if (TextUtils.isEmpty(host)) {
  93.                         return false;
  94.                     }
  95.                     String param = uri.getQueryParameter("param");
  96.                     JSONObject jsonObject = new JSONObject(param);
  98.                     String name = jsonObject.optString("name", "");
  99.                     if ("yxt_app_live_open".equals(name)) {
  100.                         String roomcode = jsonObject.optString("roomid", "");
  101.                         String password = jsonObject.optString("password", "");
  103.                         LivePullIntentDataOptions options = new LivePullIntentDataOptions();
  104.                         options.setLivePlayPwd(password);
  105.                         options.setLiveRoomCode(roomcode);
  107.                         //传入真实用户身份  此处是测试写死的
  108.                         options.setUserId("5ff44dff-82b5-4dd1-8a0a-c4c6a0a70733");
  109.                         options.setUserName("王阳明");
  110.                         options.setUserAvatar("https://thirdwx.qlogo.cn/mmopen/vi_32/DYAIOgq83eoKnUXeQnOQicPKWM8JHWH704OmhM3FRbq5icT5mhykg2NVL7epHuWIOmIDMBTCia5LiaTFmVL6Y9659Q/132");
  111.                         LivePullManager.intentToLjLive(this, options);
  112.                     }
  114.                 } catch (Exception e) {
  115.                     e.printStackTrace();
  116.                 }
  117.                 return true;
  118.             }
  119.         }
  121.         return false;
  122.     }
  124.     @Override
  125.     public void onBackPressed() {
  126.         if (yxt_webview.canGoBack()) {
  127.             yxt_webview.goBack();
  128.         } else {
  129.             super.onBackPressed();
  130.         }
  131.     }
  134. }
  • 当获取到协议之后需要获取用户可用积分；
  1.     // 正式api地址
  2.     public static final String DEFAULT_FORMAL_BASE_API = "https://api-qida.yunxuetang.cn/v1/qdl/";
  3.     // 测试api地址
  4.     public static final String DEFAULT_TEST_BASE_API = "https://devinner.yunxuetang.com.cn/qidaliveapi/v1/";
  5.     /**
  6.      * 此API用于获取用户可用积分
  7.      */
  8.     public static final String GETVALIDPOINTS = API地址 + "live/getvalidpoints";
  9.     public static void openLive(final Context mContext, final String roomId, final String playPwd) {
  10.         Alert.getInstance().showDialog();//此处是显示等待的loading效果  需自己实现
  11.         //此处为通过JavaAPI获取当前用户的可用积分,用于观看直播时对主播进行礼物赠送是的兑换
  12.         //HttpUtil需要自己实现 此处就是简单的get请求
  13.         //注意该请求头中需要携带以下参数
  14.         //1."Source" "506"
  15.         //2."Token" token从h5的localstorage获取
  16.         HttpUtil.get(GETVALIDPOINTS, new JsonHttpHandler() {
  17.             @Override
  18.             public void onSuccessJSONObject(int statusCode, JSONObject response) {
  19.                 super.onSuccessJSONObject(statusCode, response);
  20.                 //此处是获取到后台返回的积分是个jsonobject 此处需要在自己的http框架中解析得
  21.                 //此处跳转直播
  22.                 //设置跳转到临境直播时对应的参数
  23.                 LivePullIntentDataOptions options = new LivePullIntentDataOptions();
  24.                 options.setLivePlayPwd(playPwd);//设置直播观看密码
  25.                 options.setLiveRoomCode(roomId);//设置直播室roomCode
  26.                 options.setUserAvatar("");//设置用户头像url
  27.                 options.setUserId("");//设置用户userId
  28.                 options.setUserLoginName("");//设置用户登录名
  29.                 options.setUserPoint(response.optInt("validPoints", 0));//设置用户积分
  31.                 //跳转到相应临境直播播放页面,context为Activity的实例
  32.                 LivePullManager.intentToLjLive(context, options);
  33.             }
  35.             @Override
  36.             public void onFailure(int statusCode, String responseString) {
  37.                 super.onFailure(statusCode, responseString);
  38.                 //获取失败,此处跳转直播积分为0
  39.                 LivePullIntentDataOptions options = new LivePullIntentDataOptions();
  40.                 options.setLivePlayPwd(playPwd);//设置直播观看密码
  41.                 options.setLiveRoomCode(roomId);//设置直播室roomCode
  42.                 options.setUserAvatar("");//设置用户头像url
  43.                 options.setUserId("");//设置用户userId
  44.                 options.setUserLoginName("");//设置用户登录名
  45.                 options.setUserPoint(0);//设置用户积分
  46.             }
  48.             @Override
  49.             public void onFinish() {
  50.                 super.onFinish();
  51.                 Alert.getInstance().hideDialog();//此处是隐藏
  52.                 等待的loading效果  需自己实现
  53.             }
  54.         });
  55.     }

关于作者

江苏云学堂网络科技有限公司开发人员，如有问题请发送邮件至
lingy@yxt.com
cuiqq@yxt.com。