.NET Core向Azure Blob Storage流式传输视频（Hololens来源）最佳实践咨询

嘿，刚好我之前做过类似的Hololens视频流上传到Azure Append Blob的项目，用.NET Core实现的，分享下我踩过坑后总结的最佳实践，应该能帮到你～

一、先明确核心适配点 #

首先得抓住Append Blob的特性：它天生就是为持续追加写入优化的，像日志、视频流这种场景完美匹配，而且每次追加操作是原子性的，不会出现数据截断的问题——这对视频流来说太重要了，总不想播放到一半画面卡断吧？

二、Hololens端的视频捕获处理 #

Hololens这边的核心是把视频拆成适合上传的片段，推荐这么做：

• 用Hololens的MediaCapture API捕获视频，建议按2-5秒的时长片段或者100KB-1MB的字节块分割，别一次性传整个视频，也别传太小的帧（太频繁的API调用会拖慢效率）。
• 编码优先选H.264，一来体积小省带宽，二来Azure Blob支持直接流式播放H.264编码的MP4，后续播放也省心。

三、.NET Core侧的Append Blob上传实现 #

1. 依赖包选对 #

别用旧的WindowsAzure.Storage，直接用官方最新稳定版的Azure.Storage.Blobs NuGet包，性能更好，API也更简洁。

2. 初始化客户端的正确姿势 #

先确保容器和Blob存在，代码示例：

var connectionString = "你的Azure存储账户连接字符串";
var blobServiceClient = new BlobServiceClient(connectionString);
var containerClient = blobServiceClient.GetBlobContainerClient("你的容器名");
await containerClient.CreateIfNotExistsAsync(); // 先确保容器存在
var appendBlobClient = containerClient.GetAppendBlobClient("hololens-stream.mp4");

// 如果Blob还没创建，先初始化一个空的Append Blob
if (!await appendBlobClient.ExistsAsync())
{
    await appendBlobClient.CreateAsync();
}

3. 流式写入的最佳方式 #

别把整个视频片段加载到内存再上传，直接用流的方式对接，既省内存又高效：

// 假设stream是从Hololens接收的视频片段流（比如网络流、本地缓存流）
await appendBlobClient.AppendAsync(stream, stream.Length);

// 如果是持续的实时流，可以分块读取上传
byte[] buffer = new byte[8192]; // 8KB块大小，可根据网络带宽调整
int bytesRead;
while ((bytesRead = await stream.ReadAsync(buffer, 0, buffer.Length)) > 0)
{
    await appendBlobClient.AppendAsync(new MemoryStream(buffer, 0, bytesRead));
}

4. 避坑要点：块数量限制 #

这里踩过坑！Append Blob最多支持50000个块，所以如果你的视频要传很久，别每次只传几百字节的小帧，最好合并成1MB左右的块再追加——不然块数很快就到上限，到时候就没法继续写入了。

5. 异常处理与重试 #

网络波动太常见了，一定要加重试逻辑：

// 用Azure SDK自带的指数退避重试策略
var options = new BlobClientOptions
{
    Retry =
    {
        Delay = TimeSpan.FromSeconds(2),
        MaxRetries = 3,
        Mode = RetryMode.Exponential
    }
};
var blobServiceClient = new BlobServiceClient(connectionString, options);

还要捕获RequestFailedException，比如遇到409错误（Blob被其他进程占用追加），可以稍等再重试；遇到404就检查Blob是否存在，重新创建。

6. 性能优化小技巧 #

• 开启传输分片，调整并发数和块大小：

  options.TransferOptions = new TransferOptions
  {
      MaximumConcurrency = 4, // 并发数根据CPU和网络情况调
      InitialTransferSize = 1024 * 1024, // 初始块1MB
      MaximumTransferSize = 4 * 1024 * 1024 // 最大块4MB
  };
  

• 避免频繁小追加，把多个小帧合并成一个块再上传，减少API调用次数。

四、Hololens与.NET Core的传输方案 #

两种常见方案，按需选：

1. Hololens直接上传 #

给Hololens用SAS令牌（别直接给连接字符串，太不安全），SAS权限只开a（追加）和r（读取），有效期设合理点，比如1天。

2. .NET Core中转 #

如果Hololens网络不稳定，或者需要做中间处理（比如转码），用WebSocket或者HTTP分块传输：

• Hololens端用HttpClient发分块数据：

  // Hololens上的.NET Core代码（支持.NET Core 3.1+）
  using var client = new HttpClient();
  using var content = new StreamContent(videoStream);
  content.Headers.ContentType = new MediaTypeHeaderValue("video/mp4");
  await client.PostAsync("http://你的服务地址/api/upload-stream", content);
  

• .NET Core后端接口接收后直接追加到Blob：

  [HttpPost("upload-stream")]
  public async Task<IActionResult> UploadStream()
  {
      await appendBlobClient.AppendAsync(Request.Body, Request.ContentLength ?? 0);
      return Ok();
  }
  

五、后续管理与播放 #

• 可以给Blob加元数据，比如设备ID、开始时间，方便后续查询：

  await appendBlobClient.SetMetadataAsync(new Dictionary<string, string>
  {
      { "DeviceId", "Hololens-001" },
      { "StartTime", DateTime.UtcNow.ToString("o") }
  });
  

• 如果要做流式播放，直接用Blob URL就行（H.264编码的MP4大部分播放器都支持），或者对接Azure Media Services做转码和CDN加速。

六、安全与冗余提醒 #

• 别把存储账户连接字符串暴露在客户端，后端用Managed Identity访问Blob最安全，不用存任何密钥。
• 存储冗余选GRS（异地冗余），万一区域出问题，数据也不会丢。
• Hololens测试时注意带宽，要是网络慢，加个本地缓存机制，攒几个片段再批量上传，避免帧堆积。

内容的提问来源于stack exchange，提问作者brian enno