本文介绍如何使用 Web 拉流 SDK（VePlayer）开启日志上报功能，以便于您进行问题排查和数据分析，提升应用的稳定性和用户体验。开启后，SDK 会将播放过程中的相关信息发送至火山引擎服务端。

适用版本

本文档适用于最新版本的 Web 拉流 SDK，版本信息请参考发布历史，历史版本请参考历史文档。

前提条件

已完成 SDK 集成。

集成步骤

1. 登录视频直播控制台的应用管理页面，查看已创建 Web 应用的 AppID。

2. 在 logger 中传入 appId，开启日志上报，代码示例如下。

   注意

   • AppID 是您的 Web 应用的唯一标识，务必正确配置。 从 2.5.1 版本开始，未配置 AppID 时，控制台会报错提示，并使用默认 AppID 上报日志。
   • 强烈建议传入 userId 和 deviceId。 这有助于在出现播放异常时，快速定位和排查问题。如果不传入，SDK 会根据用户浏览器随机生成并在本地缓存。
   通过 CDN 集成

   通过 NPM 集成

   VePlayer.createLivePlayer({
   	  width: 640,
   	  height: 360,
   	  url: 'https://pulldomain/appname/mystream.flv',
   	  logger: {
   	    appId: '2****4',
   	    userId: '1********6',
   	    deviceId: '3********7',
   	  },
   	});
   	        
   

   import { createLivePlayer, register } from '@volcengine/veplayer';
   	import { flv } from '@volcengine/veplayer-plugin';
   	import '@volcengine/veplayer/style'
   	
   	register([flv]);
   	
   	createLivePlayer({
   	  width: 640,
   	  height: 360,
   	  url: 'https://pulldomain/appname/mystream.flv',
   	  logger: {
   	    appId: '2****4',
   	    userId: '1********6',
   	    deviceId: '3********7',
   	  },
   	});
   	        
   

3. 如果在直播过程中出现播放异常，请收集播放时间、出现的问题现象等信息，并通过创建工单，联系火山引擎技术支持进行问题定位。