管理中心

投播开发指导

系统提供了音视频发声设备统一投播组件AVCastPicker,作为播控中心系统级设备切换、投播能力选择入口。应用通过接入统一投播组件,可以实现在应用内及系统播控中心,将音视频资源通过Cast+协议/DLNA协议投播到远端设备。

通过本开发指导,完成一次音视频跨设备投播。

约束与限制

当前设备发现和设备选择均为系统能力,由投播组件AVCastPicker集成,应用通过接入投播组件实现音视频投播能力。

需同时满足以下条件,才能使用该功能:

  • 设备限制

    本端设备:HarmonyOS 5.0.0及以上版本的手机或平板设备、HarmonyOS 6.0.0及以上版本的PC/2in1设备

    远端设备:HarmonyOS 5.0.0及以上版本的PC/2in1设备、HarmonyOS 3.1及以上版本的TV设备、支持标准DLNA协议的设备

  • 使用限制

    1. 在进行投播前,双端设备均需要在设置中打开蓝牙和WIFI,并确保设备可访问网络。

    2. PC/2in1设备不支持发现PC/2in1设备。

接口说明

在开发具体功能前,请先查阅参考文档,获取详细的接口说明。

  • AVCastPicker:投播组件,提供设备发现认证连接的统一入口。

  • AVCastController:投播控制器,用于投播场景下,完成播放控制、远端播放状态监听等操作。

    说明

    AVCastController由系统获取并返回,在设备连接成功后获取,在设备断开后不能继续使用,否则会抛出异常。

    支持在线DRM视频资源投播能力,需注册DRM许可证请求回调函数,获取许可证后,调用处理许可证响应函数。

展开
接口类 接口 说明
AVSession setAVMetadata(data: AVMetadata, callback: AsyncCallback<void>): void 配置媒体信息,包括ID、标题、作者以及DRM类型等。
AVSession on(type: 'outputDeviceChange', callback: (state: ConnectionState, device: OutputDeviceInfo) => void): void 注册设备变化的回调,同时包含了设备的连接状态。
AVSession getAVCastController(callback: AsyncCallback<AVCastController>): void 获取远端投播时的控制接口。
AVCastController sendControlCommand(command: AVCastControlCommand, callback: AsyncCallback<void>): void 投播会话的控制接口,用于进行投播中的各种播控指令。
AVCastController prepare(item: AVQueueItem, callback: AsyncCallback<void>): void 准备播放,进行资源加载和缓冲,不会触发真正的播放。
AVCastController start(item: AVQueueItem, callback: AsyncCallback<void>): void 开始播放媒体资源。
AVCastController processMediaKeyResponse(assetId: string, response: Uint8Array): Promise<void> 提供DRM资源所需的秘钥。
AVCastController on(type: 'keyRequest', callback: KeyRequestCallback): void 注册DRM秘钥请求的回调。
AVCastController on(type: 'playbackStateChange', filter: Array<string> | 'all', callback: (state: AVPlaybackState) => void): void 注册播放状态变化的回调。
AVCastController on(type: 'mediaItemChange', callback: Callback<AVQueueItem>): void 注册当前播放内容更新的回调,返回当前播放的内容的信息。

开发步骤

  1. 创建播放器,并创建AVSession。

    通过AVSessionManager创建并激活媒体会话。

    示例中的context的获取方式请参见获取UIAbility的上下文信息。

    收起
    自动换行
    深色代码主题
    复制
    1. import { avSession } from '@kit.AVSessionKit'; // 导入AVSession模块。
    2. // 声明全局的session对象,此写法是加在class类外的声明,如果需要在class类内申明全局变量,需要去掉 export let。
    3. export let session: avSession.AVSession;
    4. // ...
    5. @Entry
    6. @Component
    7. struct Index {
    8. // ...
    9. // 创建session
    10. async createSession(context: common.UIAbilityContext) {
    11. // 创建的AVSession在基础播控与投播场景可以共用。
    12. session = await avSession.createAVSession(context, 'video_test', 'video'); // 'audio'代表音频应用,'video'代表视频应用
    13. // ...
    14. await session.activate();
    15. // 请按照如下参数设置,告知系统应用当前支持投播,才能成功投播。
    16. session.setExtras({
    17. requireAbilityList: ['url-cast'],
    18. });
    19. console.info(`Session created. sessionId: ${session.sessionId}`);
    20. }
    21. // ...
    22. }
  2. 设置媒体资源信息,注册基础播控回调,接入系统播控中心的基础播控。

    说明
    • 接入投播组件前需要先适配媒体播控中心的基础播控业务,具体需要接入的内容请按照应用类型参考应用接入自检表。

    • 应用可以通过filter字段设置需要发现和过滤的协议类型,来匹配应用期望的投播设备。

      注意,投播后,应用播放器切换上下集时,若下一集不支持投播,可以通过filter参数控制系统播控中心是否显示可投播设备列表,filter参数设置为0,播控会识别当前媒体内容为不支持投播,隐藏可投播设备显示。避免用户从播控中心投播,应用资源不可用。

    • 需要在AVCastPicker中仅显示支持DRM资源投播的设备时,应在AVMetadata设置明确的drmSchemes。

    收起
    自动换行
    深色代码主题
    复制
    1. // 与session声明不在同一文件时,需要import。
    2. import { avSession } from '@kit.AVSessionKit'; // 导入AVSession模块。
    3. // 声明全局的session对象,此写法是加在class类外的声明,如果需要在class类内申明全局变量,需要去掉 export let。
    4. export let session: avSession.AVSession;
    5. // ...
    6. @Entry
    7. @Component
    8. struct Index {
    9. // ...
    10. public setAVMetadata(playInfo: avSession.AVMediaDescription): Promise<void> {
    11. const metadata: avSession.AVMetadata = {
    12. assetId: playInfo.assetId, // 需要配置实际id。
    13. title: playInfo.title, // 播放媒体资源的标题。
    14. subtitle: playInfo.subtitle, // 播放媒体资源的副标题。
    15. // 发现Cast+ Stream 和 DLNA协议设备,TYPE_CAST_PLUS_STREAM为默认必选。
    16. filter: avSession.ProtocolType.TYPE_CAST_PLUS_STREAM | avSession.ProtocolType.TYPE_DLNA,
    17. mediaImage: playInfo.mediaImage,
    18. artist: playInfo.artist,
    19. // 如果是DRM资源,配置支持的DRM uuid 用于设备过滤。非DRM资源不配置。
    20. drmSchemes: ['3d5e6d35-9b9a-41e8-b843-dd3c6e72c42c']
    21. };
    22. return session.setAVMetadata(metadata);
    23. }
    24. public setSessionListener() {
    25. // 请按照自检接入表按需注册并实现基础播控的控制指令,以下为举例。
    26. session?.on('play', () => {
    27. });
    28. session?.on('pause', () => {
    29. });
    30. }
    31. // ...
    32. }
  3. 在需要投播的播放界面创建投播组件AVCastPicker。

    说明
    • 若创建AVCastPicker后应用界面未显示,或点开Picker显示空白,请排查是否按步骤1、2接入了系统播控中心的基础播控,且正确设置了AVMetadata与Extras参数。

    • 系统AVCastPicker提供CustomerPicker参数,应用可以通过该参数自定义Picker按钮的显示,具体开发请参考自定义样式。

    • 使用投播组件AVCastPicker期间需要保证avsession对象不被后台销毁,否则可能会导致切换设备失败。

    收起
    自动换行
    深色代码主题
    复制
    1. import { AVCastPickerState, AVCastPicker } from '@kit.AVSessionKit';
    2. @Entry
    3. @Component
    4. export struct AVCastPickerComponent {
    5. // 应用可以通过onStateChange接口监听组件显示/消失状态,
    6. // 当组件显示时建议不要销毁AVCastPicker的显示;当组件消失时,再根据业务隐藏AVCastPicker。
    7. private onStateChange(state: AVCastPickerState) {
    8. if (state == AVCastPickerState.STATE_APPEARING) {
    9. console.info('The picker starts showing.');
    10. } else if (state == AVCastPickerState.STATE_DISAPPEARING) {
    11. console.info('The picker finishes presenting.');
    12. }
    13. }
    14. // 创建组件,并设置大小。
    15. build() {
    16. Row() {
    17. Column() {
    18. AVCastPicker({
    19. normalColor: Color.Red,
    20. onStateChange: this.onStateChange
    21. })
    22. .width('40vp')
    23. .height('40vp')
    24. .border({ width: 1, color: Color.Red })
    25. }.height('50%')
    26. }.width('50%')
    27. }
    28. }
  4. 注册AVSession投播控制回调。用于感知投播设备连接。

    说明

    下面代码展示设备连接成功后的相应的处理

    • 连接成功后通过session获取AVCastController,用于后期的投播控制;
    • 应用监听on('outputDeviceChange')回调,在收到设备切换到对端的信息时,就可以刷新应用内的播放界面为“投播页面或遥控器页面”,并暂停本机播放。在收到切换设备到本机的信息时,可以刷新应用内的播放界面为“本地播放页面”,并开始在本机播放。
    • 可以在on('outputDeviceChange')回调中使用castCategory来判断是否连接到远端设备。
    • on('outputDeviceChange')回调具体取值来自ProtocolType,可以是protocoltype中的某个协议或多个协议的组合,设备仅支持一种协议,返回对应枚举值;设备支持多种协议,返回对应枚举值之和。
    • 如需要推送DRM在线资源,根据远端设备支持的DRM能力,从服务端获取对应的资源。
    • 推送DRM资源后,应注册监听许可证请求事件,从服务器端获取许可证后,通过处理许可证响应函数提供给远端。
    收起
    自动换行
    深色代码主题
    复制
    1. import { avSession } from '@kit.AVSessionKit';
    2. import { BusinessError } from '@kit.BasicServicesKit';
    3. // ...
    4. /**
    5. * Register the AVSession playback control callback.
    6. * Used to detect the connection of playback devices.
    7. * @param session: The AVSession to configure for casting.
    8. */
    9. getAVCastController(session: avSession.AVSession) {
    10. // 如支持投播,可使用下面接口监听设备连接状态的变化。
    11. session.on('outputDeviceChange', async (connectState: avSession.ConnectionState,
    12. device: avSession.OutputDeviceInfo) => {
    13. // 可以通过当前设备及设备连接状态来更新应用内播放界面的显示。
    14. let currentDevice: avSession.DeviceInfo = device?.devices?.[0];
    15. if (currentDevice.castCategory === avSession.AVCastCategory.CATEGORY_REMOTE &&
    16. connectState === avSession.ConnectionState.STATE_CONNECTED) { // 设备连接成功。
    17. console.info(`Device connected: ${device}`);
    18. this.castController = await session.getAVCastController();
    19. console.info('Succeeded in getting a cast controller');
    20. // 查询当前播放的状态。
    21. let avPlaybackState = await this.castController?.getAVPlaybackState();
    22. console.info(`Succeeded in AVPlaybackState resource obtained: ${avPlaybackState}`);
    23. // 监听播放状态的变化。
    24. this.castController?.on('playbackStateChange', 'all', (state: avSession.AVPlaybackState) => {
    25. console.info(`Succeeded in Playback state changed: ${state}`);
    26. });
    27. // 根据currentDevice.supportedProtocols可以判断设备支持的协议类型,设备支持单个或多个协议类型
    28. if (currentDevice.supportedProtocols === avSession.ProtocolType.TYPE_CAST_PLUS_STREAM) {
    29. // 此设备支持cast+投播协议。
    30. } else if (currentDevice.supportedProtocols === avSession.ProtocolType.TYPE_DLNA) {
    31. // 此设备支持DLNA投播协议。
    32. }
    33. // 此设备支持chinaDRM,监听许可证请求事件,也可在发起DRM资源投播前监听。
    34. if (currentDevice.supportedDrmCapabilities?.includes('3d5e6d35-9b9a-41e8-b843-dd3c6e72c42c')) {
    35. this.castController?.on('keyRequest', this.keyRequestCallback);
    36. }
    37. }
    38. })
    39. }
    40. // 处理DRM许可证请求事件。
    41. private keyRequestCallback: avSession.KeyRequestCallback = async (assetId: string, requestData: Uint8Array) => {
    42. // 根据assetId获取对应的DRM url。
    43. let drmUrl: string = 'https://www.examples.com';
    44. // 从服务器获取许可证,具体实现可参考附录。
    45. let licenseResponseData = await this.getLicense.getLicense(drmUrl, requestData);
    46. try {
    47. // 处理DRM许可证响应。
    48. await this.castController?.processMediaKeyResponse(assetId, licenseResponseData);
    49. } catch (error) {
    50. console.error(`Failed to process the response corresponding to the media key. Error: ${error}`);
    51. }
    52. }
  5. 使用AVCastController进行资源播放。

    说明

    下面代码示例中的url仅作示意使用,开发者需根据实际情况,确认资源有效性并设置:

    • 如果使用本地资源播放,必须确认资源文件可用,并使用应用沙箱路径访问对应资源,参考获取应用文件路径。应用沙箱的介绍及如何向应用沙箱推送文件,请参考文件管理。
    • 如果通过FilePicker使用用户文件,请参考选择用户文件。
    • 如果使用网络播放路径,需申请相关权限:ohos.permission.INTERNET。
    • 如果是DRM资源,需配置drmSchemes字段。
    收起
    自动换行
    深色代码主题
    复制
    1. playItem() {
    2. // 设置播放参数,开始播放。
    3. let playItem : avSession.AVQueueItem = {
    4. itemId: 0,
    5. description: {
    6. assetId: 'VIDEO-1',
    7. title: 'ExampleTitle',
    8. artist: 'ExampleArtist',
    9. // 网络资源投播,设置mediaUri; 本地资源投播,将本地文件打开后,相关的文件描述符设置到fdSrc。
    10. mediaUri: 'https://xxx.xxx.com/example.mp4',
    11. // 该字段大写,音频'AUDIO',视频'VIDEO'。
    12. mediaType: 'VIDEO',
    13. mediaSize: 1000,
    14. // startPosition为投播当前进度,设置该字段可将本机播放进度同步到远端。
    15. startPosition: 0,
    16. // 投播资源播放时长,设置该字段可将本机播放时长同步到远端显示。
    17. duration: 100000,
    18. albumCoverUri: 'https://www.examples.com',
    19. albumTitle: '《ExampleAlbum》',
    20. appName: 'ExampleApp',
    21. // DRM资源,需要配置支持的DRM类型, 以chinaDRM为例。
    22. drmScheme: '3d5e6d35-9b9a-41e8-b843-dd3c6e72c42c',
    23. }
    24. };
    25. // 准备播放,这个不会触发真正的播放,会进行加载和缓冲。
    26. this.avCastController?.prepare(playItem, () => {
    27. console.info('Preparation done');
    28. // 启动播放,真正触发对端播放。请在Prepare成功后再调用start。
    29. this.avCastController?.start(playItem, () => {
    30. console.info('Playback started');
    31. });
    32. });
    33. }
  6. 使用AVCastController,监听控制命令和进行播放控制。

    说明
    • 应用可以通过如下监听与控制指令,实现从应用内控制投播设备,及响应来自对端设备或者系统播控中心的控制。
    • 系统播控中心会按照应用的注册监听,来动态置灰和点亮控制卡片的按钮。
    • 当前系统暂不支持清晰度调节,应用如需向用户提供清晰度调节入口,需要在用户选定不同清晰度时按照新的清晰度重新下发资源。
    收起
    自动换行
    深色代码主题
    复制
    1. playControl() {
    2. // 记录从avsession获取的远端控制器this.castController。
    3. // 应用向对端设备下发播放命令。
    4. let avCommand: avSession.AVCastControlCommand = {command:'play'};
    5. this.avCastController?.sendControlCommand(avCommand);
    6. // 应用向对端设备下发暂停命令。
    7. avCommand = {command:'pause'};
    8. this.avCastController?.sendControlCommand(avCommand);
    9. // 应用调节对端设备音量。
    10. avCommand = {
    11. command: 'setVolume',
    12. parameter: 1
    13. };
    14. this.avCastController?.sendControlCommand(avCommand);
    15. // 应用调节对端设备进度。
    16. avCommand = {
    17. command: 'seek',
    18. parameter: 1
    19. };
    20. this.avCastController?.sendControlCommand(avCommand);
    21. // 更多控制指令请参考AVCastControlCommand。
    22. }
    23. controlListener() {
    24. // 应用监听对端或播控中心上下一首/上下一集切换。
    25. this.avCastController?.on('playPrevious', () => {
    26. console.info('PlayPrevious done');
    27. });
    28. this.avCastController?.on('playNext', () => {
    29. console.info('PlayNext done');
    30. });
    31. // 应用监听对端或播控中心播放状态、实时进度和音量变化事件。
    32. this.avCastController?.on('playbackStateChange', 'all', (playbackState: avSession.AVPlaybackState)=>{
    33. if (playbackState?.state) {
    34. // 播放状态变化。
    35. }
    36. if (playbackState?.position) {
    37. // 进度变化,可以根据position来获取对端播放的进度。
    38. }
    39. if (playbackState?.volume) {
    40. // 音量变化。
    41. }
    42. });
    43. // 应用监听对端投播内容播放完毕事件。应用监听到此回调,可以按照业务在以下三种选其一实现,否则无内容播放,对端出现黑屏。
    44. // 1. 有下一集时,自动切换下一集投播,此时需要调用Prepare和start重新设置新的url,参考步骤5。
    45. // 2. 无下一集时,建议循环播放同一集,重新调用prepare和start来设置当前新的url,参考步骤5。
    46. // 3. 业务不再支持投播,可以主动断开投播,参考步骤9。
    47. this.avCastController?.on('endOfStream', () => {
    48. // 按业务处理。
    49. });
    50. // 应用监听对端或播控中心的进度调节完成事件,包括快进、快退、进度条拖拽完毕。
    51. this.avCastController?.on('seekDone', (position: number) => {
    52. // seekDone表示用户在对端或是播控内进度调节完毕,可以在收到该回调后,根据'playbackStateChange'回调的position刷新绘制应用内进度条。
    53. // 应用主动调用seek调节对端进度后,也请等待seekDone回调再根据'playbackStateChange'中的position来刷新,更精准。
    54. });
    55. }
  7. 申请投播长时任务,避免应用在投播时进入后台时被系统冻结,导致无法持续投播。

    说明

    在申请长时任务时,需要在module.json5文件中:

    1. 配置长时任务权限ohos.permission.KEEP_BACKGROUND_RUNNING。
    2. 为需要使用长时任务的UIAbility声明相应的后台模式类型:AUDIO_PLAYBACK。选其一申请即可,都可保证音频在应用后台、锁屏、熄屏投播时不会被中断。
    收起
    自动换行
    深色代码主题
    复制
    1. import { backgroundTaskManager } from '@kit.BackgroundTasksKit';
    2. import { WantAgent, wantAgent } from '@kit.AbilityKit';
    3. import { BusinessError } from '@kit.BasicServicesKit';
    4. // ...
    5. async function startContinuousTask(context: Context) {
    6. let wantAgentInfo: wantAgent.WantAgentInfo = {
    7. // 点击通知后,将要执行的动作列表。
    8. wants: [
    9. {
    10. bundleName: "com.example.myapplication",
    11. abilityName: "EntryAbility",
    12. }
    13. ],
    14. // 点击通知后,动作类型。
    15. actionType: wantAgent.OperationType.START_ABILITY,
    16. // 使用者自定义的一个私有值。
    17. requestCode: 0,
    18. // 点击通知后,动作执行属性。
    19. wantAgentFlags: [wantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
    20. };
    21. // 通过wantAgent模块的getWantAgent方法获取WantAgent对象。
    22. try {
    23. wantAgent.getWantAgent(wantAgentInfo).then((wantAgentObj) => {
    24. try {
    25. backgroundTaskManager.startBackgroundRunning(context,
    26. backgroundTaskManager.BackgroundMode.AUDIO_PLAYBACK, wantAgentObj).then(() => {
    27. console.info('Succeeded in requesting to start running in background');
    28. }).catch((error: BusinessError) => {
    29. console.error(`Failed to request to start running in background. Code: ${error.code}, message: ${error.message}`);
    30. });
    31. } catch (error) {
    32. console.error(`Failed to request to start running in background. Error: ${error}`);
    33. }
    34. });
    35. } catch (error) {
    36. console.error(`Failed to get WantAgent. Error: ${error}`);
    37. }
    38. }
  8. 投播后资源切换。

    • 应用已开始投播,再次进入播放详情页时可以通过getOutputDevice()接口获取当前播放设备,来判断此时是否正在投播中。
    收起
    自动换行
    深色代码主题
    复制
    1. import { avSession } from '@kit.AVSessionKit'; // 导入AVSession模块。
    2. // ...
    3. getOutputDevice() {
    4. session?.getOutputDevice().then((outputDeviceInfo: avSession.OutputDeviceInfo) => {
    5. // 当前设备的castCategory为Remote,则表示正在投播中。
    6. let isCasting = outputDeviceInfo.devices[0].castCategory === avSession.AVCastCategory.CATEGORY_REMOTE;
    7. }).catch((err: BusinessError) => {
    8. console.error(`GetOutputDevice BusinessError: code: ${err.code}, message: ${err.message}`);
    9. });
    10. }
    • 应用已开始投播,从播放详情页退出到应用首页时,建议不要断开投播即调用stopCasting,可以给用户留一个回到“投播的界面”的入口。
    • 投播时用户在应用侧退出详情页,如果点击了其他视频播放,应用识别新的资源是否可以投播,可以根据以下两种情况处理:
      • 情况一:如新的视频资源可以投播,有以下两种方式可处理:

        方式一:直接调用prepare和start更换投播资源,参考步骤5。对端播放新的视频资源,本地显示切换为“正在投播的界面”,不需要断开投播重新投播。

        方式二:不主动切换投播资源,正常绘制应用投播业务的按钮但不要创建AVCastPicker,用户点击后直接调用prepare和start更换投播资源,本地显示切换为“正在投播的界面”,不需要断开投播重新投播。

      • 情况二:如此时不可以投播,当前视频就在本地播放,隐藏投播业务的按钮显示即可。

  9. 处理音频焦点。请参考多音频并发处理。

    在应用进入投播后,当前应用需要取消注册焦点处理事件,以免被其他应用的焦点申请而影响。

  10. 结束投播。

  • 当远端设备断开的时候,应用会收到事件,系统会自动断开连接。
  • 应用也可以使用断开投播的接口,主动进行投播连接的断开。
收起
自动换行
深色代码主题
复制
  1. async stopCasting() {
  2. try {
  3. await session.stopCasting();
  4. // ...
  5. }
  • 建议应用监听并保存AVCastController.on('playbackStateChange')回调中的position,当投播断开时,可以刷新为“本地播放详情页”在本端继续播放,并根据这个position来调整本地播放的进度。

镜像投屏自动切换资源投播

适用场景:用户通过“无线投屏”功能实现手机等设备和大屏等的镜像投屏,然后打开视频应用进入视频播放,此时会自动切换为资源投播。要达到上述目标体验,还需要做一些额外的适配工作。

  1. 应用进入播放页后,需要调用getOutputDevicesync接口来判断当前是否存在投屏的设备,避免和其他应用冲突。

    通过开发步骤第四步进行投播设备判断,如果存在投播设备,表示此时可以进行资源投播;否则表示没有可以投播的设备,或者系统当前虽然在镜像投屏,此时有别的APP在投播,此时应用应在本地播放。

  2. 应用正常投播后,仍然监听设备状态断开等场景,流程同投播组件开发步骤中的内容描述。

附录

从服务器获取许可证

开发者需要根据实际的资源和服务地址获取DRM许可证,以下示例代码仅作为参考。

收起
自动换行
深色代码主题
复制
  1. import { http } from '@kit.NetworkKit';
  2. export class GetLicense {
  3. // 获取DRM许可证, 仅做参考,需要结合实际资源和服务地址进行获取。
  4. async getLicense(drmUrl: string, requestData: Uint8Array): Promise<Uint8Array | undefined> {
  5. let licenseRequestStr: string = this.byteToString(requestData);
  6. let licenseResponseStr: string = 'defaultStr';
  7. let httpRequest = http.createHttp();
  8. try {
  9. let response: http.HttpResponse = await httpRequest.request(drmUrl, {
  10. method: http.RequestMethod.POST,
  11. header: {
  12. 'Content-Type': 'application/json',
  13. 'Accept-Encoding': 'gzip, deflate',
  14. },
  15. extraData: licenseRequestStr,
  16. expectDataType: http.HttpDataType.STRING,
  17. });
  18. if (response?.responseCode == http.ResponseCode.OK) {
  19. if (typeof response.result == 'string') {
  20. licenseResponseStr = response.result;
  21. }
  22. }
  23. httpRequest.destroy();
  24. } catch (error) {
  25. console.error(`Failed to request Http. Error: ${error}`);
  26. return undefined;
  27. }
  28. return this.stringToByte(licenseResponseStr);
  29. }
  30. /**
  31. * Uint8Array to string.
  32. * @param arr Uint8Array.
  33. * @returns string.
  34. */
  35. byteToString(arr: Uint8Array): string {
  36. let str: string = ''
  37. let _arr: Uint8Array = arr
  38. for (let i = 0; i < _arr.length; i++) {
  39. // 将数值转为二进制字符串。
  40. let binaryStr: string = _arr[i].toString(2)
  41. let matchArray = binaryStr.match(new RegExp('/^1+?(?=0)/'))
  42. if (matchArray && binaryStr.length == 8) {
  43. let bytesLength: number = matchArray[0].length
  44. let store: string = _arr[i].toString(2).slice(7 - bytesLength)
  45. for (let j = 1; j < bytesLength; j++) {
  46. store += _arr[j + i].toString(2).slice(2)
  47. }
  48. str += String.fromCharCode(Number.parseInt(store, 2))
  49. i += bytesLength - 1
  50. } else {
  51. str += String.fromCharCode(_arr[i])
  52. }
  53. }
  54. return str
  55. }
  56. /**
  57. * string 转 Uint8Array。
  58. * @param str string.
  59. * @returns Uint8Array.
  60. */
  61. stringToByte(str: string): Uint8Array {
  62. let bytes: number[] = new Array();
  63. let unicode: number
  64. for (let i = 0; i < str.length; i++) {
  65. unicode = str.charCodeAt(i)
  66. if (unicode >= 0x010000 && unicode <= 0x10FFFF) {
  67. bytes.push(((unicode >> 18) & 0x07) | 0xf0)
  68. bytes.push(((unicode >> 12) & 0x3F) | 0x80)
  69. bytes.push(((unicode >> 6) & 0x3F) | 0x80)
  70. bytes.push((unicode & 0x3F) | 0x80)
  71. } else if (unicode >= 0x000800 && unicode <= 0x00FFF) {
  72. bytes.push(((unicode >> 12) & 0x07) | 0xf0)
  73. bytes.push(((unicode >> 6) & 0x3F) | 0x80)
  74. bytes.push((unicode & 0x3F) | 0x80)
  75. } else if (unicode >= 0x000800 && unicode <= 0x0007FF) {
  76. bytes.push(((unicode >> 6) & 0x3F) | 0x80)
  77. bytes.push((unicode & 0x3F) | 0x80)
  78. } else {
  79. bytes.push(unicode & 0xFF)
  80. }
  81. }
  82. return new Uint8Array(bytes);
  83. }
  84. }

音视频投播示例代码

系统投播功能支持用户将手机上的音视频无缝流转到其他设备(如PC/2in1设备、TV设备)上继续播放,实现跨终端自由切换。为简化开发流程,系统提供了标准化的音视频投播解决方案,开发者仅需配置资源信息、监听投播状态并实现播放控制(如播放、暂停等),即可快速集成该功能。

具体可参考音频投播 与视频投播。