表示 MediaLayer 源中引用的视频元素。MediaLayer 可显示 web 浏览器支持的视频。有关支持的视频类型,请参阅通用编解码器文档。
图像和视频元素的坐标可以在任何空间参考中指定,并可投影到视图的空间参考。内容在坐标之间呈线性拉伸,因此建议图像或视频与视图的空间参考相匹配,以正确对齐,尤其是对于覆盖整个地球等大区域的内容。
// create a video element by setting video param to point to the video file url
// set the geographic location of the video file on the map using an extent
const element = new VideoElement({
video: "https://arcgis.github.io/geoscene-samples-javascript/sample-data/media-layer/videos/hurricanes_aerosol-aug.mp4",
georeference: new ExtentAndRotationGeoreference({
extent: new Extent({
xmin: -150,
ymin: 1,
xmax: 20,
ymax: 80,
spatialReference: {
wkid: 4326
}
})
})
});
已知限制
VideoElement
当前在 iPhones 上不受支持。
构造函数
属性概述
名称 | 类型 | 描述 | 类 |
---|---|---|---|
HTMLVideoElement | 视频元素实例中引用的视频内容。 更多详情 | VideoElement | |
String | 类的名称。 更多详情 | Accessor | |
ExtentAndRotationGeoreference|CornersGeoreference|ControlPointsGeoreference | 要放置在地图上的图像或视频元素的地理位置。 更多详情 | VideoElement | |
Number | 元素的不透明度。 更多详情 | VideoElement | |
String | 元素类型。 更多详情 | VideoElement | |
String|HTMLVideoElement | 要添加到媒体图层源的视频元素。 更多详情 | VideoElement |
属性详细信息
-
content HTMLVideoElementreadonly
-
视频元素实例中引用的视频内容。内容与视频参数中引用的视频相匹配。
-
类的名称。声明的类名称格式化为
geoscene.folder.className
。
-
要放置在地图上的图像或视频元素的地理位置。可以通过指定元素的范围和旋转、边界框的角点或定义控制点来设置位置。
已知限制
- 目前,ControlPointsGeoreference 在 3D SceneViews 中不受支持。
示例// create a new ExtentAndRotationGeoreference const geoReference = new ExtentAndRotationGeoreference({ extent: new Extent({ spatialReference: { wkid: 102100 }, xmin: -10047456.27662979, ymin: 3486722.2723874687, xmax: -10006982.870152846, ymax: 3514468.91365495 }) }); const imageElement = new ImageElement({ image: "https://arcgis.github.io/geoscene-samples-javascript/sample-data/media-layer/new-orleans/neworleans1891.png", georeference: geoReference });
// create a canvas image element by setting its corner points of the bounding box const canvasElement = new ImageElement({ image: canvas, georeference: new CornersGeoreference({ bottomRight: new Point({ x: -121.369, y: 45.061 }), bottomLeft: new Point({ x: -122.363, y: 45.061 }), topRight: new Point({ x: -121.369, y: 45.678 }), topLeft: new Point({ x: -122.363, y: 45.678 }) }) });
// georeference an ImageElement, using ControlPointsGeoreference in the // North American Datum 1927 spatial reference const spatialReference = new SpatialReference({ wkid: 4267 }); const swCorner = { sourcePoint: { x: 80, y: 1732 }, mapPoint: new Point({ x: -107.875, y: 37.875, spatialReference }) }; const nwCorner = { sourcePoint: { x: 75, y: 102 }, mapPoint: new Point({ x: -107.875, y: 38, spatialReference }) }; const neCorner = { sourcePoint: { x: 1353, y: 99 }, mapPoint: new Point({ x: -107.75, y: 38, spatialReference }) }; const seCorner = { sourcePoint: { x: 1361, y: 1721 }, mapPoint: new Point({ x: -107.75, y: 37.875, spatialReference }) }; const controlPoints = [swCorner, nwCorner, neCorner, seCorner]; const georeference = new ControlPointsGeoreference({ controlPoints, width: 1991, height: 2500 }); const imageElement = new ImageElement({ image: "https://jsapi.maps.arcgis.com/sharing/rest/content/items/1a3df04e7d734535a3a6a09dfec5a6b2/data", georeference });
-
opacity Number
-
元素的不透明度。此值的范围在 1 到 0 之间,其中 0 是 100% 透明,而 1 为完全不透明。
- 默认值:1
-
type Stringreadonly
-
元素类型。
对于 VideoElement,类型总是 "video"。
-
-
要添加到媒体图层源的视频元素。例如,视频元素可以是指向视频的 URL 字符串。
示例// create a video element by setting video param to point to the video file url // set the geographic location of the video file on the map using an extent const element = new VideoElement({ video: "https://arcgis.github.io/geoscene-samples-javascript/sample-data/media-layer/videos/hurricanes_aerosol-aug.mp4", georeference: new ExtentAndRotationGeoreference({ extent: new Extent({ xmin: -150, ymin: 1, xmax: 20, ymax: 80, spatialReference: { wkid: 4326 } }) }) }); // add the video element to the media layer const layer = new MediaLayer({ source: [element], title: "2017 Hurricanes and Aerosols Simulation", copyright: "NASA's Goddard Space Flight Center" });
方法概述
名称 | 返回值类值 | 描述 | 类 |
---|---|---|---|
添加一个或多个与对象的生命周期相关联的句柄。 更多详情 | Accessor | ||
Boolean | 如果存在指定的句柄组,则返回 true。 更多详情 | Accessor | |
移除对象拥有的句柄组。 更多详情 | Accessor |
方法详细说明
-
addHandles(handleOrHandles, groupKey)inherited起始版本:GeoScene Maps SDK for JavaScript 4.25
-
添加一个或多个与对象的生命周期相关联的句柄。当对象被销毁时,将移除句柄。
// Manually manage handles const handle = reactiveUtils.when( () => !view.updating, () => { wkidSelect.disabled = false; }, { once: true } ); // Handle gets removed when the object is destroyed. this.addHandles(handle);
参数handleOrHandles WatchHandle|WatchHandle[]对象销毁后,标记为要移除的句柄。
groupKey *optional标识句柄应添加到的组的键。组中的所有句柄稍后都可使用 Accessor.removeHandles() 进行删除。如果未提供键,则句柄将被添加到默认组。
-
起始版本:GeoScene Maps SDK for JavaScript 4.25
-
如果存在指定的句柄组,则返回 true。
参数groupKey *optional组键。
返回类型 描述 Boolean 如果存在指定的句柄组,则返回 true
。示例// Remove a named group of handles if they exist. if (obj.hasHandles("watch-view-updates")) { obj.removeHandles("watch-view-updates"); }
-
removeHandles(groupKey)inherited起始版本:GeoScene Maps SDK for JavaScript 4.25
-
移除对象拥有的句柄组。
参数groupKey *optional要移除的组键或组键的数组或集合。
示例obj.removeHandles(); // removes handles from default group obj.removeHandles("handle-group"); obj.removeHandles("other-handle-group");