HarmonyOS 鸿蒙Next中动态图片保存至图库报错

视频资源检查不通过，视频不要超过10秒。

把附件下载后去掉.txt，放resource目录下的resfile(没有建一个)里，跑下面代码就可以在相册生成动态图片。

import { photoAccessHelper } from '@kit.MediaLibraryKit';
import { common } from '@kit.AbilityKit';
// ...

@Entry
@Component
export struct Scene1 {
  @State statusMessage: string = '';
  @State imageSource: string = '';

  saveButtonOptions: SaveButtonOptions = {
    icon: SaveIconStyle.FULL_FILLED,
    text: SaveDescription.SAVE_IMAGE,
    buttonType: ButtonType.Capsule
  }// Set properties of SaveButton.

  // ...

  build() {
    NavDestination() {
      Column({ space: 20 }) {
        SaveButton(this.saveButtonOptions)
          .onClick(async (event, result: SaveButtonOnClickResult) => {
            if (result == SaveButtonOnClickResult.SUCCESS) {
              try {
                let context: Context = this.getUIContext().getHostContext() as common.UIAbilityContext;
                let phAccessHelper = photoAccessHelper.getPhotoAccessHelper(context);
                // Ensure that the assets specified by imageFileUri and videoFileUri exist.
                let imageFileUri = 'file://' + context.resourceDir + '/hello.jpeg';
                let videoFileUri = 'file://' + context.resourceDir + '/sea.mp4';//加载的视频不要超过10秒

                let assetChangeRequest: photoAccessHelper.MediaAssetChangeRequest =
                  photoAccessHelper.MediaAssetChangeRequest.createAssetRequest(context,
                    photoAccessHelper.PhotoType.IMAGE, 'jpg', {
                      title: 'moving_photo',
                      subtype: photoAccessHelper.PhotoSubtype.MOVING_PHOTO
                    });

                assetChangeRequest.addResource(photoAccessHelper.ResourceType.IMAGE_RESOURCE, imageFileUri);
                assetChangeRequest.addResource(photoAccessHelper.ResourceType.VIDEO_RESOURCE, videoFileUri);

                await phAccessHelper.applyChanges(assetChangeRequest);

                this.statusMessage = 'create moving photo successfully, uri: ' + assetChangeRequest.getAsset().uri;
                console.info('create moving photo successfully, uri: ' + assetChangeRequest.getAsset().uri);
              } catch (err) {
                this.statusMessage = `create moving photo failed with error: ${err.code}, ${err.message}`;
                console.error(`create moving photo failed with error: ${err.code}, ${err.message}`);
              }
            } else {
              this.statusMessage = 'SaveButtonOnClickResult create moving photo failed';
              console.error('SaveButtonOnClickResult create moving photo failed');
            }
          })

        // ...

      }
      .width('100%')
      .height('100%')
    }
    .title('Save Moving Photo')
  }
}

1. 代码逻辑解析

代码片段使用了华为 photoAccessHelper API（基于 HarmonyOS 文档），核心流程如下：

// 1. 创建动态照片请求（类型为 IMAGE，子类型为 MOVING_PHOTO）
const changeRequest = photoAccessHelper.MediaAssetChangeRequest.createAssetRequest(
  context,
  photoAccessHelper.PhotoType.IMAGE, // 资源类型：图片
  imageExtension,
  {
    title: util.generateRandomUUID(),
    subtype: photoAccessHelper.PhotoSubtype.MOVING_PHOTO // 动态照片类型
  }
);

// 2. 添加资源（关键步骤）
changeRequest.addResource(
  photoAccessHelper.ResourceType.IMAGE_RESOURCE, 
  { file: '/data/storage/el2/.../1779351671492.jpg' } // 图片资源路径
);
changeRequest.addResource(
  photoAccessHelper.ResourceType.VIDEO_RESOURCE, 
  { file: '/data/storage/el2/.../1779351671492.mp4' } // 视频资源路径
);

// 3. 提交请求（触发报错）
await photoAccessHelper.applyChanges(changeRequest);

2. 关键报错点

• 错误码 401：在 HarmonyOS 中，401 通常表示 权限不足 或 资源未通过安全校验。
• 错误信息：Failed to check video resource of moving photo
  明确指向 视频资源检查失败，说明问题出在 VIDEO_RESOURCE 的处理环节。

3. 可能原因分析

4. 解决方案建议

✅ 步骤 1：检查权限声明

在 module.json5 中添加必要权限：

{
  "module": {
    "reqPermissions": [
      {
        "name": "ohos.permission.WRITE_MEDIA",
        "reason": "保存动态照片需要写入媒体库"
      },
      {
        "name": "ohos.permission.READ_MEDIA",
        "reason": "读取视频资源需要权限"
      }
    ]
  }
}

✅ 步骤 2：验证视频资源

• 确保视频文件路径有效（通过 file API 检查文件是否存在）。
• 确认视频格式为 MP4（HarmonyOS 动态照片通常要求 H.264 编码）。
• 检查路径是否属于应用沙箱（如 context.filesDir 路径）。

✅ 步骤 3：参考官方文档规范

• 动态照片需同时提供 图片（.jpg） 和 视频（.mp4），且两者需为同一内容（如视频截图与视频匹配）。
• 严格按文档示例构造 createAssetRequest 参数（官方文档链接）。

✅ 步骤 4：调试建议

• 在 addResource 后添加日志，确认视频文件路径是否可读：

console.log("Video file exists:", await file.exists(videoPath));

• 捕获更详细的错误信息：

catch (err) {
  console.error("Detailed error:", JSON.stringify(err));
}

总结

该报错的核心是 视频资源校验失败，需优先排查 权限、路径有效性、视频格式 三方面问题。

401 错误在 HarmonyOS 中多与权限相关，建议先确保权限声明完整，并验证视频资源的合规性。

（注：动态照片功能需同时满足图片和视频的规范，缺一不可）