当前位置：首页 > news >正文

【IOS】【OC】【应用内打印功能的实现】如何在APP内实现打印功能，连接本地打印机，把想要打印的界面打印成图片

news 2025/5/30 15:28:49

【IOS】【OC】【应用内打印功能的实现】如何在APP内实现打印功能，连接本地打印机，打印想打印的界面

设备/引擎：Mac（14.1.1）/cocos

开发工具：Xcode

开发语言：OC/C++

开发需求：工程中需要为用户提供一个打印功能，让用户可以随时打印自己想要打印的界面

APP属于iOS工程，所以打印代码考虑直接用OC代码调用iOS原生界面就可以，很好用，也不用自己去写UI，也比较适合短周期开发的情况，话不多说，直接正文

1.打印代码
大致过程是这样的，OC代码判断获取到的图片信息是否合法，再调用iOS原生的打印控制器，判断是否有可用的打印机，最后用户点击打印即可……
获取图像部分

    @autoreleasepool {// 获取 Document 路径NSString* docsDir = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES).firstObject;NSString* imagePath = [docsDir stringByAppendingPathComponent:[NSString stringWithUTF8String:filename]];UIImage* image = [UIImage imageWithContentsOfFile:imagePath];if (!image) {NSLog(@"[PrintHelper] 图片未找到：%@", imagePath);return;}.........

Tips：整段代码用autoreleasepool包裹起来可以让其中的临时对象在代码块结束后及时释放，避免内存泄露

判断打印控制器是否可用并设置打印内容

        UIPrintInteractionController* printController = [UIPrintInteractionController sharedPrintController];if (!printController || ![UIPrintInteractionController canPrintData:UIImagePNGRepresentation(image)]) {NSLog(@"[PrintHelper] 当前设备无法打印图片。");return;}printController.printingItem = image; //设置打印内容

异步显示iOS原生打印对话框

dispatch_async(dispatch_get_main_queue(), ^{

弹出打印界面 + 打印结果回调

[printController presentAnimated:YES completionHandler:^(UIPrintInteractionController * _Nonnull controller, BOOL completed, NSError * _Nullable error) {if (error) {NSLog(@"[PrintHelper] 打印失败：%@", error.localizedDescription);} else if (completed) {NSLog(@"[PrintHelper] 打印完成。");} else {NSLog(@"[PrintHelper] 用户取消打印。");}
}];

至此iOS原生打印代码就算完成了

2.获取打印图片代码
这个就是你想打印的部分，我们的工程中涉及打印的就是涂色相关的玩法，所以有两种方法可以获取打印区域，一种是获取你需要打印的多个画布，将这些画布内容渲染出来保存为图片文件再打印；还有一种方法是直接对屏幕内容进行局部截图处理，将截好的图直接传过去进行打印
1）获取多个画布节点，将他们都渲染到一张新画布上，然后再打印出来
创建画布

   // 1. 创建一张足够大的 renderTextureCCSize targetSize = CCSizeMake(winSize.width, winSize.height); // 设置尺寸CCRenderTexture* rt = CCRenderTexture::create(targetSize.width, targetSize.height);rt->beginWithClear(1,1,1,1);  // 白底

获取多张ColoringClippingNode画布并渲染

   for (int i = 0; i < m_ClipDrawArray->count(); i++) {ColoringClippingNode* clip = (ColoringClippingNode*)m_ClipDrawArray->objectAtIndex(i);if (!clip) continue;// 保存原始位置CCPoint oldClipPos = clip->getPosition();// 计算偏移，使其居中绘制CCPoint centeredPos = ccp(winSize.width/2, winSize.height/2);if(i==0){clip->setPosition(ccp(winSize.width*0.65, winSize.height/2));}else{clip->setPosition(centeredPos);}// 直接visit整个clip节点，节点上的遮罩也会生效clip->visit();// 恢复原始位置clip->setPosition(oldClipPos);}

如果有需要渲染的sprite精灵也需要加进来

   auto sprite = whiteCanvas;if (sprite){// 保存auto oldA = sprite->getAnchorPoint();auto oldP = sprite->getPosition();// 设置锚点和位置到大图中心sprite->setAnchorPoint(ccp(0.5f,0.5f));sprite->setPosition(ccp(targetSize.width/2, targetSize.height/2));sprite->visit();// 恢复sprite->setAnchorPoint(oldA);sprite->setPosition(oldP);}

都渲染之后就是结束画布渲染

   rt->end();

保存渲染好的画布；调用打印代码

 rt->saveToFile("printScene.png", kCCImageFormatPNG);  //将画布保存为PNG并命名
// 延迟调用打印代码，避免未渲染保存就打印CCDirector::sharedDirector()->getScheduler()->scheduleSelector(schedule_selector(ColorCanvasView::callPrintImage),this, 0, 0, 0.3f, false);

以上就是通过将多张画布及精灵渲染到一张画布再保存成文件，最后打印的过程，下面再说说如何通过截屏操作来打印

2）对屏幕想要打印的区域进行截屏保存，再打印
截屏代码

   @autoreleasepool {// 获取根控制器和屏幕信息AppController *app = (AppController *)[UIApplication sharedApplication].delegate;UIViewController *viewController = [app viewController];UIView *targetView = viewController.view;CGFloat scale = [UIScreen mainScreen].scale;CGSize viewSize = targetView.bounds.size;

        // 1. 截屏UIGraphicsBeginImageContextWithOptions(viewSize, NO, scale);[targetView drawViewHierarchyInRect:CGRectMake(0, 0, viewSize.width, viewSize.height) afterScreenUpdates:YES];UIImage *fullImage = UIGraphicsGetImageFromCurrentImageContext();UIGraphicsEndImageContext();if (!fullImage) {NSLog(@"截屏失败");return;}

        // 2. 裁剪区域CGRect cropRect = CGRectMake(x * scale, y * scale, width * scale, height * scale);CGImageRef croppedCGImage = CGImageCreateWithImageInRect(fullImage.CGImage, cropRect);if (!croppedCGImage) {NSLog(@"裁剪失败");return;}UIImage *croppedImage = [UIImage imageWithCGImage:croppedCGImagescale:scaleorientation:fullImage.imageOrientation];CGImageRelease(croppedCGImage);CGSize targetSize = CGSizeMake(width, height);UIGraphicsBeginImageContextWithOptions(targetSize, NO, scale);

一般还是需要对截屏区域进行缩放，保证打印时图像大小位置合适
缩放居中代码

        CCSize winSizes = GameManager::sharedManager()->getViewVisibleSize();// 4. 缩放CGFloat shrinkScale = 0.85;CGFloat offX_x=0.3;CGSize scaledSize = CGSizeMake(croppedImage.size.width * shrinkScale, croppedImage.size.height * shrinkScale);// 5. 计算居中位置CGPoint origin = CGPointMake((targetSize.width - scaledSize.width) *offX_x, (targetSize.height - scaledSize.height) / 2.0);// 6. 居中绘制缩小后的图像[croppedImage drawInRect:CGRectMake(origin.x, origin.y, scaledSize.width, scaledSize.height)];// 7. 得到最终图像UIImage *finalImage = UIGraphicsGetImageFromCurrentImageContext();UIGraphicsEndImageContext();

最后就是将图像保存为文件

        // 8. 保存图像到文件NSData *imageData = UIImagePNGRepresentation(finalImage);if (!imageData) {NSLog(@"图片数据为空");return;}NSString *docsDir = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES).firstObject;NSString *imagePath = [docsDir stringByAppendingPathComponent:[NSString stringWithUTF8String:filename]];if ([imageData writeToFile:imagePath atomically:YES]) {NSLog(@"图片保存成功：%@", imagePath);} else {NSLog(@"图片保存失败");}

以上就是如何通过OC代码来进行截屏操作，接下来就是在工程中如何调用

    float x = winSize.width*widthX_x; // 起始横坐标（point）float y = winSize.height*heightOffY; // 起始纵坐标（point）float w = winSize.width*widthOffX; // 宽度float h = winSize.height; // 高度const char* filename = "printScene.png";DeviceManager::sharedManager()->printSceneAddedToFile(filename, x, y, w, h);
// 延迟调用打印代码，避免未渲染保存就打印CCDirector::sharedDirector()->getScheduler()->scheduleSelector(schedule_selector(ColorCanvasView::callPrintImage),this, 0, 0, 0.3f, false);