VideoContext.setMediaVolume
收藏我的收藏
基础库 2.65.0 开始支持本方法,低版本需做兼容处理,这是一个异步方法。
设置音量。
| 前提条件 | 无 | 
| 业务背景 | 无 | 
| 使用限制 | 无 | 
| 注意事项 | 无 | 
| 支持沙盒 | 否  | 
| 相关教程 | 无 | 
语法
VideoContext.setMediaVolume(options)
参数说明
options 为 object 类型,属性如下:
| 属性名 | 类型 | 默认值 | 必填 | 说明 | 最低支持版本 | 
|---|---|---|---|---|---|
| value | number | 是 | 要设置的音量值,范围 [0, 1],精度到小数点后 1 位  | 2.65.0 | |
| success | function | 否 | 接口调用成功的回调函数  | 2.65.0 | |
| fail | function | 否 | 接口调用失败的回调函数  | 2.65.0 | |
| complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行)  | 2.65.0 | 
回调成功
object 类型,属性如下:
| 属性名 | 类型 | 说明 | 最低支持版本 | 
|---|---|---|---|
| errMsg | string | "VideoContext.setMediaVolume:ok"  | 2.65.0 | 
回调失败
object 类型,属性如下:
| 属性名 | 类型 | 说明 | 最低支持版本 | 
|---|---|---|---|
| errMsg | string | "VideoContext.setMediaVolume:fail" + 详细错误信息  | 2.65.0 | 
扫码体验
请使用字节宿主APP扫码
代码示例
<video id="video" src="https://sf1-ttcdn-tos.pstatp.com/obj/ttfe/test/test-upload.mp4"></video> <button bindtap="setMediaVolume">setMediaVolume</button>
Page({ data: {}, setMediaVolume() { const videoContext = tt.createVideoContext("video"); videoContext.setMediaVolume({ value: 1, success: (res) => { console.log("setMediaVolume success: ", res); }, fail: (res) => { console.log("setMediaVolume fail: ", res); }, complete: (res) => { console.log("setMediaVolume complete: ", res); }, }); }, });
