---
name: "getMediaUrl"
mode: "api"
versionRequirements:
  - { name: "@ray-js/lock-sdk", version: "1.0.0" }
title: "getMediaUrl - 获取视频的实际播放地址。"
summary: "获取视频的实际播放地址。"
---

## getMediaUrl

> [VERSION] @ray-js/lock-sdk >= 1.0.0

### 描述

获取视频的实际播放地址

### 参数

| 参数 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| `mediaPath` | `string` | 是 | 媒体路径 |
| `mediaBucket` | `string` | 是 | 媒体桶 |

### 返回值

类型: `Promise<MediaUrlResult>`

可播放的媒体 URL（或宿主约定的地址字段）

##### MediaUrlResult

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `mediaUrl` | `string` |  |

### 示例代码

#### 示例

```ts
import { getMediaUrl } from '@ray-js/lock-sdk';
const url = await getMediaUrl();
```