audio_service v18继承MediaItem重写BaseAudioHandler方法报错如何解决？

问题原因 #

Dart的方法重写要求参数类型符合逆变规则，父类BaseAudioHandler的addQueueItem方法定义的参数类型是MediaItem，意味着该方法可以接收所有MediaItem及其子类的实例。你在子类中把参数类型缩小为CustomMediaItem，相当于限制了方法可接收的参数范围，不符合重写规则，因此会触发编译报错。

解决方案 #

方案1：不修改参数类型，方法内部做类型校验转换

重写时保持参数类型为MediaItem，在方法内部先做类型判断再转换为你的自定义类使用，这是最安全的方案：

@override
Future<void> addQueueItem(MediaItem item) async {
  // 类型校验
  if (item is CustomMediaItem) {
    // 转换后直接访问自定义属性
    final customItem = item;
    print(customItem.customClass);
    // 你的业务逻辑
  } else {
    // 可根据业务需求处理普通MediaItem的情况，比如抛出异常或者兼容处理
    throw ArgumentError('仅支持传入CustomMediaItem类型');
  }
}

方案2：使用covariant关键字放宽编译校验

如果你能确保业务逻辑中永远不会传入普通MediaItem实例到这个方法，可以用covariant关键字告诉编译器你自愿承担类型风险，允许参数类型替换为子类：

@override
Future<void> addQueueItem(covariant CustomMediaItem item) async {
  // 直接访问自定义属性即可
  print(item.customClass);
  // 你的业务逻辑
}

注意：如果运行时传入了普通MediaItem实例，会直接抛出类型转换异常。

方案3：新增自定义方法避免重写冲突

如果不需要兼容原有addQueueItem的调用约定，可以不重写父类方法，自己定义专属的自定义方法来接收CustomMediaItem：

// 自定义方法，无重写冲突
Future<void> addCustomQueueItem(CustomMediaItem item) async {
  // 直接使用自定义属性
  print(item.customClass);
  // 内部可按需调用父类的addQueueItem方法
  await super.addQueueItem(item);
}

对外调用时直接使用你自定义的addCustomQueueItem方法即可，完全类型安全。

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