云服务器内容精选

  • setLogLevel setLogLevel(level: string): boolean 【功能说明】 设置Console上打印的日志级别,如不设置日志级别,则console日志打印级别默认为error。 【请求参数】 level:string类型,必选,日志级别标识。 none:关闭全部级别的日志打印。 error:打印error级别日志。 warn:打印warn级别及更高级别日志。 info:打印info级别及更高级别日志。 debug:打印debug级别及更高级别日志。 【返回参数】 boolean:设置日志级别结果。true表示日志级别设置成功,false表示日志级别设置失败。
  • setReportConfig setReportConfig(reportConfig:ReportConfig):boolear 【功能说明】 设置打点能力以及打点和日志上传的认证策略。 【请求参数】 reportConfig:ReportConfig类型,必选。ReportConfig定义如下所示: enable:必选,布尔类型,true表示开启打点,false表示关闭打点。默认true。 tokenConfig:可选,对象定义如下所示: enable:布尔类型,true表示开启认证,false表示关闭认证。默认false。 tokenInfo:数组类型,数组内部ReportTokenInfo类。ReportTokenInfo定义如下所示: appid:string类型。传入appid。 expTimestamp:string类型。过期时间戳,系统当前UNIX时间戳加上鉴权过期时间(推荐7200秒,最长需要小于43200秒,即12个小时)。 例如:当前UNIX时间戳为:1708531200,鉴权过期时间自定义为7200秒,那么过期的时间戳为:1708538400,即表示该校验字符串在2024-02-22 02:00:00过期。 token:string类型。hmac_sha256生成的字符串。hmac_sha256(共享密钥, 过期的时间戳 + appID)。共享密钥由用户控制获取。 【返回参数】 返回值布尔值, true表示设置成功,false表示设置失败。 开启了认证策略,实际请求状态会通过on函数注册Error回调获得。
  • setParameter setParameter(parameterKey: string, parameterValue: any): boolean 【功能说明】 设置全局配置参数。 【请求参数】 参数名称 参数值 LOADING_CONFIG LoadingConfig类型,定义如下: { netQualityLoading:可选,boolean类型。true表示开启根据网络质量进行loading效果展示,默认值为false,关闭。 netQualityLoadingThreshold:可选,number类型。展示loading效果的网络质量(network-quality)的阈值,默认网络质量等级为5。 frameStuckLoading:可选,boolean类型。true表示开启根据帧卡顿时长进行loading效果展示,默认值为false frameStuckThreshold:可选,number类型。展示loading效果帧卡顿时长的阈值,单位为100ms。默认值为10,表示帧卡顿时长为1000ms。 } 注意: 需要在起播之前进行设置。 DNS_QUERY_ENABLE boolean类型,可选,默认为false,true表示开启DNS结果解析,false表示关闭DNS结果解析。 AC CES S_DOMAIN string类型,可选,默认为空,主要用于拉流环境配置,沟通华为工程师填入。 GLSB_DOMAIN string类型,可选,默认为空,主要用于GSLB环境配置,沟通华为工程师填入。 【返回参数】 boolean:配置参数设置结果。true表示参数设置成功,false表示参数设置失败。
  • createClient createClient(type: string): HWLLSClient | HWFlvClient | HWHlsClient 【功能说明】 创建一个直播拉流客户端对象,如果需要拉取多个直播流则需要创建多个客户端对象。 【请求参数】 type:string类型,可选。创建的拉流客户端类型。 低时延直播拉流客户端类型:webrtc。 flv直播拉流客户端类型:flv。 HLS直播拉流客户端类型:hls(预留,暂未开放)。 缺省值:webrtc。 【返回参数】 client:拉流客户端对象。
  • 软件包完整性校验 用户可对下载的SDK包进行完整性校验,判断下载过程中是否存在篡改和丢包现象。 详细操作如下所示: 在表1中下载SDK包及其完整性校验sha256包至本地。 打开本地命令提示符框,输入如下命令,在本地生成已下载SDK包的SHA256值。 其中,“D:\HWLLS_SDK_Web_2.6.0.tar.gz”为SDK包本地存放路径和SDK包名,请根据实际情况修改。 certutil -hashfile D:\HWLLS_SDK_Web_2.6.0.tar.gz SHA256 命令执行结果示例,如下所示: SHA256 的 D:\HWLLS_SDK_Web_2.6.0.tar.gz 哈希: 3ac83be852e8dcc9e90f236801fd4c494983073543e1ae66ee4d0c29043dccd1 CertUtil: -hashfile 命令成功完成。 比对查询出的SDK包SHA256值和下载后的SDK包SHA256值。 如果一致,说明下载过程中不存在篡改和丢包现象。
  • 常见问题 如果业务上App只能使用http协议,是否能够集成使用华为低时延直播Web SDK ? 部分浏览器(chrome)可以集成使用,但不推荐。由于浏览器兼容性识别是根据浏览器暴露的WebRTC对象判断的,在非https协议下,对象可能不存在。 Firefox浏览器中无法使用华为低时延直播Web SDK? Firefox浏览器使用之前需要安装H264的编解码插件。浏览器中输入about:addons,跳转到插件安装页面,查看H264插件是否安装完成,如未安装请在该页面更新安装。 集成华为低时延直播Web SDK后,无法正常使用,可能原因? 需要检查用户自定义的 域名 配置是否完成,如:推、拉流域名,权威机构签发的https证书等。 推流端设置及推流是否正常。 播放地址是否填写正确,如:appName、streamName等。 网络连接是否正常、网络防火墙配置是否有限制,如:UDP端口(8000-8063)是否放通。 华为低时延直播Web SDK,支持哪些类型浏览器? 浏览器支持详情请参见浏览器适配。 推流端推流成功后,华为低时延直播Web SDK拉流播放失败? 需要确认推流端的推流编码参数,是否为H264+无B帧。目前华为低时延直播Web SDK仅支持H264+无B帧的流,所以如果原始流为H265或者带B帧,则需要提前在租户Console上配置对应转码模板,开启转码服务,但这样会引入额外的转码延迟,并且会产生转码费用。建议推流端尽量推H264+不包含B帧的流,可以通过调整推流端软件(如OBS)的视频编码参数去除B 帧。如果使用OBS推流,可以通过设置,关闭B帧。如下图所示: 华为低时延直播Web SDK,播放报错:NotAllowedError:xxx? 由于浏览器自动播放安全策略的限制,浏览器直接拉起App并启动播放会返回该错误,在应用层需要根据该错误码,引导用户通过手动触发页面UI控件,并调用replay接口恢复播放。 开启认证策略,该如何获取token信息? 认证策略不开启不影响功能正常使用,也不影响打点和日志上传的能力。 认证策略开启可以保证打点数据和日志上传数据的安全性。 如果当前需要认证策略能力,请提交工单,联系技术支持获取appid和token。 父主题: Web SDK
  • 使用限制 一个租户最多支持创建500个频道。如果有更多的频道需求,请提交工单扩容。 除了“FLV_PULL”输入类型的频道,其他所有频道仅支持单路入流,且必须经过转码后,才能提供多码率出流。 “SRT_PUSH”输入类型的频道,为了保障可靠性,必须满足下述条件: “SRT_PUSH”输入类型的频道支持主备双URL,编码器要同时向主备双URL推流。 如果编码器支持streamid,默认只返回一个输入URL,示例如图1所示。 如果需要主备Region同时双推,请提交工单处理。 图1 频道详情 如果编码器不支持streamid,会同时返回主备输入URL,示例如图2所示。 图2 频道详情 编码器推流断链时,需具备主动重推能力。建议断链重推周期小于一个分片时长。
  • 管理频道 频道新增完成后,您还可以根据实际需要进行如下操作。 启用频道 频道创建完成后,若您需要使用,请单击操作列的“启动”,启用频道。 停用频道 如果频道需要停止,请单击操作列的“停止”,停用频道。 修改频道配置 如果需要修改频道,请单击操作列的“管理”,修改频道的配置项。如果修改的频道是启用状态,那么修改完成后,自动重启,重启耗时约30s。频道重启过程中,音视频流会中断,待重启完成后,自动恢复。 删除频道 如果频道需要删除,需要先停用,再单击操作列的“删除”,删除频道。
  • 功能特性 华为云媒体直播提供了创建媒体直播转码模板、创建频道等功能,广泛地用于直播业务的PGC平台等场景。具体如表1所示。 表1 功能特性 类别 特性名称 特性说明 直播控制台 总览 支持查看直播的今日下行流量、下行带宽峰值等数据。 支持变更直播的CDN计费模式。 域名管理 支持新增、删除、停用、启用媒体直播推流域名和播放域名。 频道管理 支持创建、启用、修改、停用、删除频道。 直播转码 支持创建、修改、删除媒体直播转码模板。 业务监控 支持查看播放域名的监控信息,包括下行带宽/流量、请求响应返回的所有状态码和下行并发数。 云资源授权 如果频道需要开启DRM加密,且“对接模式”设置为“FunctionGraph代理访问”,需要提前开启FunctionGraph资源委托授权。授权成功后,媒体直播服务才能查询用户的函数、工作流、触发器,并调用函数。 回看地址生成 支持获取频道回看URL,回看频道历史播放内容。
  • 添加媒体直播域名 您需要将自有的已备案的推流域名、播放域名分别添加到 视频直播 服务中。下面以添加推流域名为例,播放域名的添加步骤与此相同。 登录视频直播控制台。 在左侧导航树中,选择“域名管理”进入域名管理页面。 单击“添加域名”。在弹出的“添加域名”页面输入已申请的推流域名。 注意:若您的域名未备案,将添加失败,并提示“添加域名失败:ICP编号不存在”。 表1 域名参数说明 参数名 描述 域名 输入二级推流域名或播放域名,域名长度需要在42个字符以内,不区分大小写。 注意:推流域名与播放域名不能相同,不支持添加泛域名。 示例:“test-push.example.com”。 说明: 默认每个账号下最多可创建64个域名。如有特殊需求,请您提交工单与华为云技术客服联系。 企业项目 将域名加入到企业项目中统一管理。 请参见创建企业项目完成企业项目的创建,默认为default企业项目。 在企业项目页面创建企业项目,然后将用户组添加到该企业项目。这时用户组内用户将获得用户组授权的该企业项目下的域名的相关操作权限。 说明: 仅企业账号能够配置企业项目。 域名类型 若“域名”中输入的是推流域名则选择推流域名,否则,选择播放域名。域名类型配置后不可更改。 子服务类型 直播服务的子服务类型。 包括如下选项: 云直播:流式直播服务,提供灵活易用,功能丰富的直播加速能力,适用娱乐、电商、教育等场景。 媒体直播:广播级直播服务,支持频道管理、内容加密等特性,适用于媒资,广电等场景。 请选择“媒体直播”。 直播源站 直播源站所在地域,可参考如何选择直播源站和加速区域?选择。直播源站配置后不可更改,建议您选择业务就近的源站。 目前支持如下区域: 中国站北京四入口,支持区域:华北-北京四。 国际站新加坡入口,支持区域:亚太-新加坡、中东-利雅得。 “中东-利雅得”区域默认不开放,如需使用,请提交工单与华为云技术客服联系。 加速区域 播放域名可执行加速的地域,可参考如何选择直播源站和加速区域?选择。仅对播放域名有效,推流域名不支持设置。设置完成后,不支持修改。 如果在所选加速区域之外播放,将无法保证功能和质量,请您根据实际业务,选择有效的加速区域。 包含如下选项: 中国大陆 当观众在中国大陆时,应选择此项。 域名需要在工信部备案,推荐您在华为云备案中心备案。 中国大陆境外 当观众在海外、中国香港、中国澳门、中国台湾时,应选择此项。 全球加速 当观众在中国大陆、中国香港、中国澳门、中国台湾或其他国家和地区时,应选择此项。 域名需要在工信部备案,推荐您在华为云备案中心备案。 单击“确定”。 在“域名管理”页面的列表中会新增一条“状态”为“配置中”的域名记录。大概3-5分钟时间,当“状态”为“正常”时,域名添加成功。 执行步骤1-步骤4,完成对播放域名的添加。
  • 总览 登录视频直播控制台,进入“总览”页面。 图1 总览 在该页面可查看如下信息,也可以单击右上角的“使用指南”,查看操作文档。 今日数据 下行流量:今日所有播放域名使用播放加速产生的下行流量总和。 下行带宽峰值:今日所有播放域名使用播放加速产生的下行带宽峰值。 使用趋势:查询近期的直播用量趋势。 下行流量:所有播放域名在查询时间段内,使用播放加速消耗的总下行流量。 下行带宽:所有播放域名在查询时间段内,使用播放加速消耗的总下行带宽峰值。 上行带宽:所选播放域名在查询的时间段内,对应推流端产生的总上行带宽。 可将鼠标放置在图表上,查看具体数值,滚动鼠标滚轮可整体加长或缩短展示横轴的时间段。 计费模式:用户当前的CDN计费方式。可以单击“变更”,变更CDN计费方式。也可以单击“购买套餐包”,购买价格更优惠的套餐包使用。 客户等级为V0和V1的账户暂不支持变更计费方式,只能按流量计费。
  • 功能列表 您可以在视频直播控制台的左侧导航栏中选择对应功能,进行配置或使用。 表1 控制台功能介绍 分类 功能 功能介绍 域名管理 域名配置 支持用户添加并管理自有的加速域名,并查看域名的CNAME值。 HTTPS证书配置 如果媒体直播的播放地址需要使用https://开头的地址,需要参考HTTPS证书配置,配置HTTPS证书。 频道管理 创建频道 您可以在媒体直播开始前,创建频道。 媒资输入类型包括: FLV_PULL:无需执行推流操作,直接获取用户提供的音视频拉流URL,媒体直播服务从URL拉流直接推流到源站。 如果媒资输入类型为“FLV_PULL”时,拉流URL仅支持HTTP协议,暂不支持其他协议。 RTMP_PUSH:需要配置推流域名,并执行推流操作。 直播转码 创建直播转码模板 支持对媒体直播视频进行转码模板配置,将推送的媒体直播流转码成多种分辨率和码率规格的,以满足不同网络环境的用户观看需求。 业务监控 业务监控 支持查看播放域名的监控信息,包括下行带宽/流量、请求响应返回的所有状态码和下行并发数。 云资源授权 云资源授权 如果频道需要开启DRM加密,且“对接模式”设置为“FunctionGraph代理访问”,需要提前开启FunctionGraph资源委托授权。授权成功后,媒体直播服务才能查询用户的函数、工作流、触发器,并调用函数。 工具库 获取频道回看URL 支持用户获取频道回看URL。
  • 操作步骤 登录视频直播控制台。 在左侧导航树中选择“域名管理”,进入域名管理页面。 单击“添加域名”。在弹出的“添加域名”页面,输入已申请的播放域名。 注意:若您的域名未备案,将添加失败,并提示“添加域名失败:ICP编号不存在”。 图2 添加域名 表1 域名参数说明 参数名 描述 域名 输入二级推流域名或播放域名,域名长度需要在42个字符以内,不区分大小写。 注意:推流域名与播放域名不能相同,不支持添加泛域名。 示例:“test-push.example.com”。 说明: 默认每个账号下最多可创建64个域名。如有特殊需求,请您提交工单与华为云技术客服联系。 企业项目 将域名加入到企业项目中统一管理。 请参见创建企业项目完成企业项目的创建,默认为default企业项目。 在企业项目页面创建企业项目,然后将用户组添加到该企业项目。这时用户组内用户将获得用户组授权的该企业项目下的域名的相关操作权限。 说明: 仅企业账号能够配置企业项目。 域名类型 若“域名”中输入的是推流域名则选择推流域名,否则,选择播放域名。域名类型配置后不可更改。 子服务类型 直播服务的子服务类型。 包括如下选项: 云直播:流式直播服务,提供灵活易用,功能丰富的直播加速能力,适用娱乐、电商、教育等场景。 媒体直播:广播级直播服务,支持频道管理、内容加密等特性,适用于媒资,广电等场景。 请选择“媒体直播”。 直播源站 直播源站所在地域,可参考如何选择直播源站和加速区域?选择。直播源站配置后不可更改,建议您选择业务就近的源站。 目前支持如下区域: 中国站北京四入口,支持区域:华北-北京四。 国际站新加坡入口,支持区域:亚太-新加坡、中东-利雅得。 “中东-利雅得”区域默认不开放,如需使用,请提交工单与华为云技术客服联系。 加速区域 播放域名可执行加速的地域,可参考如何选择直播源站和加速区域?选择。仅对播放域名有效,推流域名不支持设置。设置完成后,不支持修改。 如果在所选加速区域之外播放,将无法保证功能和质量,请您根据实际业务,选择有效的加速区域。 包含如下选项: 中国大陆 当观众在中国大陆时,应选择此项。 域名需要在工信部备案,推荐您在华为云备案中心备案。 中国大陆境外 当观众在海外、中国香港、中国澳门、中国台湾时,应选择此项。 全球加速 当观众在中国大陆、中国香港、中国澳门、中国台湾或其他国家和地区时,应选择此项。 域名需要在工信部备案,推荐您在华为云备案中心备案。 单击“确定”。 在“域名管理”页面的列表中会新增一条“状态”为“配置中”的域名记录。大概3-5分钟时间,当“状态”为“正常”时,域名添加成功。 请参考3~4,新增一条推流域名。 域名添加完成后,您需要在播放域名和推流域名的DNS服务商处配置CNAME,将您的域名指向CDN配置的CNAME地址。 具体操作请见配置CNAME,配置完成后,对应的域名会自动启用直播加速服务。
  • 注意事项 海外直播价格和国内直播价格不同,计费详情请参见价格详情。 在所选加速区域之外使用此播放地址,无法保证功能和播放质量。 如果播放域名的加速区域为“中国大陆”或“全球加速”,而推流域名的直播源站为中国大陆境内时,域名均需要完成中国大陆的域名备案。 视频直播服务可能会分配一个默认的推流域名给用户,如下所示: 国内推流域名格式:{projectid}.hwcloudlive.com 示例:0c283a271****************9459b6a.hwcloudlive.com 海外推流域名:{projectid}.ott.huawei 示例:0c283a271****************9459b6a.ott.huawei 上述推流域名为服务内部使用域名。如果用户被分配了上述域名,虽然可见,但不支持调用或使用。且对正常使用Live无影响,也不会引起额外的费用,可无需关注。
  • 操作步骤 登录视频直播控制台。 在左侧导航栏中,选择“域名管理”,进入域名管理页面。 请根据实际需求选择以下操作。 查看域名信息 在域名列表中,可查看已添加域名的CNAME值、域名类型、状态及创建时间等信息。 图1 域名状态 单击右侧操作列的“管理”,可查看目标域名的详细基本信息。 停用域名 停用域名后,该域名下正常启动的媒体直播频道会无法提供服务。域名停用状态下,受影响的频道均无法重新启动。 若您需要停用某个域名,可以在需要停用的域名行单击“停用”。当“状态”变为“停用”时,表示域名停用成功。 启用域名 若您需要将某个已停用的直播域名重新启用,可以在需要启用的域名行单击“启用”。当“状态”变为“正常”时,表示域名启用成功。 删除域名 注意:仅在“停用”状态下的域名才能删除。因此,您需要先停用不需要的域名,再在需要删除的域名行单击“删除”即可。